ret /* c.sqrt calculate the square and */ 
/* square root of a number */ 


#include <h.stdio> 
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ACORN’S NEW CONSUMER 
STRATEGY 


We reported last month on Acorn’s new 
marketing initiative which goes under the 
name of The Learning Curve, and also 
referred briefly to price reductions announced 
for the entire Archimedes range. The 
Learning Curve is a packaged A3000 system 
with additional software and other supporting 
materials which is being aimed strongly at the 
domestic consumer market, rather than the 
more specialist educational market on which 
Acorn has appeared to concentrate since the 
launch of the Archimedes range. 


There is no denying, of course, the 
importance of the educational market to 
Acorn, nor its strength and dominance in this 
field. Indeed, Acorn is clearly using its position 
here in support of its new initiative. However, 
many previous BBC micro enthusiasts will 
remember back to the days when it seemed 
that nearly every high street store up and 
down the country was selling BBC micros, 
and Acorn’s presence in the domestic market 
was a force to be reckoned with. 


Sadly, Acorn seems to have given less 
attention in recent years to the army of 
enthusiasts who have long been their 
champions, and indeed many users of other 
micros have joined their ranks, particularly 
since the launch of the A3000 last year. 


Hopefully, the latest initiative marks a change 
of heart by Acorn, and together with the price 
reductions on the rest of the range this will 
lead to much greater market penetration in 
this more popular but highly competitive area. 
If so this will be good news for all Archimedes 


users, as an increasing user base ultimately 
benefits all users, providing a larger market 
for all potential third party suppliers (and 
encourage involvement from larger software 
houses) as well as providing Acorn with the 
return which it needs. We certainly wish 
Acorn well in its latest endeavours. 


RETAIL CATALOGUE 


You will find no Retail Catalogue included 
with this issue of RISC User. Our intention is to 
produce a comprehensive catalogue four 
times a year with supplements as and when 
appropriate. The catalogue distributed with 
the last issue will therefore remain the current 
catalogue for the next month or so, until a 
new edition is sent to you. This will happen 
automatically so there is no need to contact 
us to specifically request this. 


We suggest that you file each catalogue away 
so that it is available for future reference, 
although further copies will be available on 
request if you no longer have a copy to hand. 


NEXT ISSUE OF RISC USER 

The next issue of RISC User will be that for 
July/August which we expect to mail out 
towards the end of June, approximately two 
weeks later than the pattern established 
earlier this year (we are sorry for the later than 
expected arrival of the May issue for reasons 
beyond our control). We will then return to 
‘our normal schedule of publication in the first 
half of the preceding month with effect from 
the September issue, which we expect to mail 
out in the first half of August. 

M.CW. 
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EXPANSION CARD FROM MORLEY 


Morley Electronics has announced an 
expansion card for the A3000 which 
provides a user port and an analogue-to- 
digital converter. The card fits into the 
internal podule slot, with the connectors 
easily accessible at the rear of the machine. 
Both the user port and the ADC are 
compatible with the BBC micro in terms of 
Osbyte commands and the Basic ADVAL 
command. The card also contains an IIC 
connector, which offers further interfacing 
possibilities. The card costs £79.35 inc. VAT. 
Further details can be obtained from Morley 
Electronics, Morley House, West Chirton, 
North Shields, Tyne & Wear NE29 7TY, tel. 
(091) 257 6373, 


GAMES GALORE 


More games have been released recently by 
Minerva. Talisman is a graphic adventure 
which involves guiding a wizard around a 
castle in search of the hidden pieces of the 
talisman. Bug Hunter and Moon Dash come 
together on one disc. In Bug Hunter you 
control a creature which moves around a 
house exterminating insects, while in Moon 
Dash you must escape through waves of 
aliens to warn your city of impending 
attack. Talisman costs £14.95 inc. VAT, and 
Bug Hunter /Moon Dash costs £17.95 inc. 
VAT. Minerva can be contacted at 69 
Sidwell Street, Exeter EX4 6PH, tel. (0392) 
421762. 


Also new on the games front is Apocalypse 
from The Fourth Dimension, by the same 
author as the highly successful Holed Out 
and E-Type. Apocalypse is an exciting shoot- 
’em-up which has been specially created for 
the Archimedes and makes use of stunning 
3-dimensional graphics and fast animation 
to produce a game which is claimed to be 
the author’s best to date. The price is £29.95 
inc, VAT. For more details contact The 
Fourth Dimension at Dept. 4444, 1 Percy 
Street, Sheffield S3 8AU, tel. (0742) 700661. 


GOING PUBLIC 


Public domain software has been available 
for other computers for a long time, but now 


PD libraries are beginning to emerge for 
Archimedes software. STWPD has a library 
of over 85 discs, covering applications and 
utilities, graphics, sound, animations, 
games etc. The library is expanding its list 
all the time. To obtain a catalogue, send a 
stamped addressed envelope to STWPD, 12 
Mornington Road, Radlett, Herts WD7 7BL. 
If you enclose a blank formatted disc and 
sufficient postage it will be returned with 
some free software. 


GETTING SPLICED 


Budding film makers may be interested in 
Splice from Ace Computing. It provides a 
wide range of editing facilities for animated 
sequences, using the output from Ace’s 
Mogul film-making software, or from a 
sequence of sprites created with an art 
package. Using Splice, you can delete or 
insert frames, join sequences, import and 
export frames from and to art packages, 
alter the shape of a film, run it backwards, 
or create cartoons by amending one frame 
at a time. Splice is available at a special 
introductory price of £30.00 inc. VAT. The 
address for Ace Computing is 27 Victoria 
Road, Cambridge CB4 3BW, tel. (0223) 
322559. 7 


LASER DIRECT 


Computer Concepts’ new laser printer, 
which was described in our News pages in 
Volume 3 Issue 1, is expected to be available 
by the time this issue is published. Called 
the Laser Direct, and based on the Qume 
Liquid Crystal Printer, it will cost £1148.85 
ine. VAT, which includes the printer, 
interface board and printer driver software. 
An expansion board, costing £286.35, will be 
available to drive the Canon LPB4 laser 
printer at up to 600 dpi, producing near 
typeset quality output. For further 
information contact Computer Concepts 
at Gaddesden Place, Hemel Hempstead 
HP2 6EX, tel. (0442) 63933. 


FLARE UP 


A new art package has been released by 
Silica Software Systems, called Flare. 
Claimed to be user-friendly and to provide 
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many facilities at an attractive price, Flare 
offers all the features to be expected from 
an art package, such as shape routines, 
area manipulation and colour mixing, 
producing a range in excess of 32000 
shades. Flare costs £19.99 inc. VAT, with an 
educational discount of 25%. Multi-user 
licences are also available. For more details 
contact Silica Software Systems, Mallards, 
Lower Hardres, Canterbury CT4 5NU, tel. 
(0227) 70279. 


DIGITISER NEWS 


Pineapple is now supplying an add-on 
adaptor box to allow its video digitiser to be 
used with the A3000. The box contains its 
own power supply, and connects to the 
computer via a ribbon cable. The price is 
£74.75 inc. VAT. 


The software for the digitiser has also been 
updated, and now provides powerful noise 
reduction and outline drawing facilities. 
For further information contact Pineapple 
Software, 39 Brownlea Gardens, Seven 
Kings, Ilford IG3 9NL, tel. (081) 599 1476. 


ARXE SYSTEMS 


Arxe Systems is a new software house for 
the Archimedes with plans to produce a 
wide range of software. First to be released 
will be MultiF'S (£35.00 inc. VAT). This will 
provide access via the standard RISC OS 
filer to MS-DOS (including a PC Emulator 
partition), Atari DOS and BBC DFS format 
discs. Promised shortly is ArmSim, a 
software developers’ aid which will allow 
ARM code to be single-stepped, and 
CBreeze, which is an editor for C 
programmers, with many useful facilities. 
Prices for these two items have yet to be 
fixed. Arxe Systems Ltd can be contacted at 
279b Romford Road, Forest Gate, London 
E7 9Hd, tel. (081) 534 1198. 


SCOTTISH COMPUTER SHOW 


Readers in Scotland will be interested to 
hear that Acorn will be exhibiting at the 
Scottish Computer Show, to be held from 9- 
11 May at the Scottish Exhibition and 
Conference Centre in Glasgow. The Acorn 
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stand will feature a full range of 
equipment, including A3000, Archimedes 
and R140 computers, and the CD-ROM 
system developed jointly with Next 
Technology, and also the Learning Curve 
project announced in last month’s RISC 
User. 


STORAGE SYSTEMS FROM CUMANA 


Cumana has now made several of its high 
density data storage systems available for 
the Archimedes and A3000. The removable 
disc cartridge system is similar in concept 
to a floppy disc but has a storage capacity of 
20Mbytes. It is encased in a rigid plastic 
cover, and can be removed from the drive 
just like a floppy. Cumana is supplying 
combined external drive systems for the 
Archimedes and A3000, containing a SCSI 
hard drive, with a choice of three capacities, 
and a 20Mbyte disc cartridge drive. Prices 
are £1247.75 with a 40Mb hard drive, 
£1518.00 with 80MB, and £1581.25 with 
105Mb, all prices inclusive of VAT. The 
20Mb removable cartridges cost £46.00 inc. 
VAT each. 


Cumana has also released its rewritable 
optical disc system for the Arc. For £4255.00 
ine. VAT, A3000 and Archimedes users can 
buy a SCSI drive unit which stores a 
massive 594Mbytes on a double-sided 
magneto-optical removable cartridge. If this 
is not enough for you, spare cartridges can 
be purchased at £247.50 inc. VAT each. 


Cumana supplies internal SCSI interfaces 
for the A3000 at £171.35 inc. VAT, and for 
the Archimedes at £228.85 inc. VAT. For 
further details on all these products, 
contact the company at The Pines Trading 
Estate, Broad Street, Guildford GU3 3BH, 
tel. (0483) 503121. 


TELEPHONE NUMBERS 


By the time this issue appears, London 
telephone numbers will have changed from 
(01) to (071) or (081) as appropriate. Don’t 
forget, however, that if you access bulletin 
boards etc., and have the numbers stored 
within your software, these will need 
changing too. RU 
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Archimedes Software 


Disc 7 - A New Chess Program for The Archimedes. 

At last, a Chess program that takes full advantage of RISC OS. Chess is now a 
true RISC OS application, installing itself on the icon bar and running on the 
desktop in a window at the same time as other applications. This means you 


can carry on working with other programs whilst the Chess program is thinking 


; 4 of its next move. 

; R Features: load and save games, edit board, step backwards and forwards 
through game, computer 'v' computer mode, play black or white, reverse board, 
save game setup. multiple levels, print game. Moves displayed in algebraic 
notation. Full mouse control over game, on screen clocks, Hint. Choice of piece 
when promoting pawn. New better design of board and pieces. Undo move. 
Complete with full Acorn ANSI C V3.00 source code - a model C !application. 
A good chess game that fits beautifully into RISC OS. 


brushes, airbrush, auto-shader, colour fills. define graduated palettes. effects 
(pixel average, area squash/stretch/distort/rotate. sphere wrap, cylinder wrap. 
Online help, manual, 14 demo pictures and 24 fonts. 


Disc 22 - Novapaint 16 colour paint package. 
Extensive paint package with Fontmaster two tone font system. user defined 


Disc 23 Desktop Applications 
Disc of RISC OS !applications, 24 system fonts, sprites and Draw files. Includes 


!!Fastdesk, !Backpict, IFileHelp, !CopyOpts, !FontFix, !Pointer(1-3), ![RomSprite, 
!Indicator, !Saver, !SectCopy, !SoundOff, !Timer, !FormatTxt. 


Disc 24 - RISC OS Terminals 
TASKData and TASKansi multitasking RISC OS desktop terminals for Viewdata 
and ANSI/VT100. Logon scripts. CET and XMODEM file transfer. !|RS423State. 


Also available: 


EMACS. Classic multi document editor with macro language. Includes full C source. 
XLISP. Object oriented version of LISP with C source and progs. New 2.00 version. 
C Toolkit. 20+progs for C programmers with sources. grep, awk, make, sed, more... 
Kermit. Archimedes, BBC and MSDOS versions of file transfer/comms. prog. 
CrossStar. Wimp based crossword solver with huge dictionary. 

More C Tools. yace and lex with examples and C source. diff, ctags, valspeak... 
Little SmallTalk. Original object oriented language with C source, docs, programs. 
GNU Tools#1. Quality tools with source. grep, egrep, sed, awk, diff. New versions. 
Clip Art#1 50 black and white pictures, also 65 Epson LQ printer fonts, !Sparkplug 
Spark. RISC OS file and directory archiver. Ibackdrop, pd. lapps. 1Mb colour pics. 
MTV Raytracer, database driven 3D raytracing package with C source code. 
Starchart. RISC OS program to make Draw file starmaps. Catalog of 9000 stars. 
More U Tools. Patch. Suite of programs to handle shar files, Rh, like ‘find’, executes 
commands on files, Csplit, GnuDbm - GNU database manager. All with C sources. 


Each disc is £5.99 inc. Buy four claim another one free! 
David Pilling, P.O. Box 22, Thornton Cleveleys, Blackpool. FY5 1LR. 


Free Air Mail delivery on overseas orders. Full list available on request. 


Introducing C 


David Spencer looks at the power of C as a programming language for 


the Archimedes. 


C is now a major programming 
language for the Archimedes. In this 
introductory article we will take a look at 
the advantages of C over, say, Basic, 
Assembler and other languages such as 
Pascal. We will also take a detailed look at 
what you will need to get started in C in 
terms of software. In future articles we 
shall look at choosing and using a C 
compiler, and programming in C. 


WHAT IS C? 

A history lesson first. C is a high-level 
programming language that was developed 
in the 1970s. The term high-level is used to 
distinguish algorithmically based 
languages from those that are specific to 
machine hardware, namely assembler 
languages. Basic and Pascal are both 
examples of high-level languages. C was 
derived from an older language called 
BCPL via an inbetween language known 
as B. It was developed largely by two 
individuals - Brian Kernighan and Dennis 
Ritchie, both of whom worked for AT&T 
(American Telephone and Telegraph). 


One of the main reasons for developing 
C was to use it to implement the entire 
UNIX operating system, which was also 
emerging from AT&T at that time. This 
intended use for C can give us some 
insight into why many people view C as 
the only programming language worth 
using, and why it has survived where 
others have failed. 


Clearly, for any language to be suitable 
for implementing an operating system it 
must be flexible enough to allow 
operations such as accessing registers in 
hardware devices. It is also essential that 
an operating system is as bug-free as 
possible, as any bugs are likely to have an 
effect on any applications run under that 
operating system. To achieve this, the 
language used must have adequate error 
checking to pick up potential problems, 
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and should ideally be ‘natural’ enough 
that code can be written easily - it is no 
use if the programmer continually has to 
allow for idiosyncrasies in the language. 
Another important criterion is that a 
programming project the size of an: 
operating system must be easily handled. 
Just imagine a 50000 line Basic program, 
and how hard it would be to find a 
particular function in it. 


Unfortunately, these criteria are to an 
extent mutually exclusive. Any language 
that is flexible enough to allow direct 
access to hardware is wide open to obscure 
bugs, as the programmer is by necessity 
able to perform functions which would be 
thought of as ‘illegal’. However, C has 
managed to strike a happy medium as we 
shall see shortly, and this explains partly 
why it is so popular. Other high-level 
languages always fail to satisfy the criteria 
in one or more respects. For example, 
Pascal is very restrictive when it comes to 
hardware access and the like, while Forth, 
for instance, is awkward to debug. 


You might also ask: "Why not use 
Assembler instead?". Certainly Assembler 
will allow you to do everything you can do 
in C, but it is a low-level language. This 
would mean that what might be a month 
long programming project in C leading to 
a 1000 line program could become a year 
long project resulting in a 5000 line 
program if Assembler was used instead. 
Add to this problems of debugging, and 
you are best off leaving Assembler for the 
few cases where it is essential, such as 
writing fast routines for handling 
hardware interrupts. 


THE STRUCTURE OF AC SYSTEM 

Unlike Basic, which is an interpreted 
language, C is a so-called compiled 
language. With an interpreted language, 
the program is stored largely as it was 
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entered, and when it is executed the 
interpreter takes each statement in turn 
and performs the necessary operations to 
implement the statement. 


Interpreted languages have their 
advantages and disadvantages. On the 
plus side, they are quick and easy to use - 
you can simply type in a program and run 
it. This can be very handy for short 
programs, or when you simply want to try 
something out quickly. The main 
disadvantage is one of speed. Each time 
the program is executed the interpreter 
has to examine it statement by statement. 
Typically, the time taken to actually 
execute the statement makes up only a 
fraction of the total time taken to decode 
the statement and decide on what action 
to take. A second disadvantage is that to 
execute an interpreted program, a copy of 
the interpreter must always be present. 
This is not a problem with Basic on the 
Archimedes, as the Basic interpreter is in 
the RISC OS ROMs. However, on some 
systems, having to load the interpreter 
each time an application is run could be a 
real problem. Another, often overlooked 
disadvantage, is that each statement in an 
interpreted program is only examined 
when it is actually executed. As we shall 
see shortly, each statement of a compiled 
program is looked at as a separate stage 
before it is run. The advantage of this is 
that major errors in the syntax of the 
program can be picked up and cured at an 
earlier stage. 


Compiled languages on the other hand 
operate entirely differently. The program 
is entered as it would be for any language, 
and is then saved. The program is referred 
to as the source code. Next, the compiler is 
invoked. This takes the source code and 
converts it piece by piece into a machine 
code program which performs the 
necessary operations. This machine code 
is called the object code. The major 
advantage of this method is that as the 
program is converted into machine code, it 
will run much faster than an interpreted 
equivalent. The main disadvantage is that 


debugging is harder because if an error is 
thrown up at compile time or run time you 
have to go back, edit the source code, and 
then recompile it all - a lengthy process 
sometimes. 


LIBRARIES AND LINKING 

In practice, the situation is more 
involved. C doesn't in itself contain any 
built-in functions to perform operations 
such as arithmetic or printing. Instead, 
these functions are provided separately in 
the form of a library. The functions in the 
library may themselves be written in C, or 
in assembler, or in a totally different 
language, and they can in turn call other 
library functions. 


Using library functions in a C program 
is a two stage process. Firstly, a 
declaration of the function must be 
included in the source code. The purpose 
of this is to specify the entry and exit 
parameters of the functions. While it 
would be possible to type in such a 
declaration for each function into each 
program, it is more normal to include 
one or more standard headers in the 
program using a special compiler 
instruction illustrated later. These 
headers are supplied with the compiler 
and include declarations for all the 
library functions. 


The second stage is to combine the 
code for the library functions with the 
object code from the compiler. This is done 
by a tool called a linker which takes the 
object code and merges in the necessary 
routines from the library code. The output 
of the linker is a stand-alone program that 
can be executed without needing an 
interpreter to be loaded. 


C STANDARDS 

Over the years, many C compilers have 
been produced, and unfortunately, many 
variations of the language have emerged 
since the Kernighan and Ritchie (K&R) 
original. In an attempt to resolve this 
situation, a standard definition of C is 
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currently being drawn up by ANSI (the 
American National Standards Institute). 
This standard is still technically in a draft 
state, though it is unlikely that it will 
change in any major way, and hence a 
compiler written to the draft standard 
should survive the test of time. 


One of the main areas in which the 
ANSI standard has helped is the range of 
library functions available. The original 
K&R definition made no mention of the 
library and this meant that programs 
couldn't be ported from one system to 
another, because even if a particular 
function existed in both libraries, you 
couldn't guarantee that it took the same 
parameters or returned the same results. 


WRITING DESKTOP 
APPLICATIONS IN C 

Where C really comes into its own on 
the Archimedes is in writing Desktop 
applications: in other words those that 
run under the Wimp. If you have been 
following our series Mastering the Wimp, 
you may have realised that a large 
amount of work is involved in 
implementing even the most trivial of 
tasks. The major problems lie in setting 
up routines to poll the Wimp and handle 
operations such as redrawing windows. 


Both the Acorn and BEEBUG C 
compilers described below provide a 
library of functions called RISCOS_LIB, 
in addition to the library of standard 
functions, One of the main features of 
RISCOS_LIB is that it provides routines 
to handle all the Wimp polling for you. All 
you have to do is provide functions to be 
called whenever a mouse button is clicked, 
or the window needs redrawing etc. 


Furthermore, functions are provided to 
handle complex tasks such as managing 
dialogue boxes, colour selection, rendering 
of Draw files and so on. RISCOS_LIB also 
contains a set of functions to implement 
an entire text editor along the lines of 
Edit. 
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To save memory in a multi-tasking 
environment, programs can be compiled to 
use a common set of library routines in 
the form of a module, rather than each 
application having the library linked into 
it. At present this only applies to the 
standard ANSI library functions, although 
future versions of RISC OS will include 
RISCOS_LIB in the module as well. 


All in all, this makes C the only 
language to consider for the writing of 
major Desktop applications. 


A SAMPLE C PROGRAM 

To conclude this introductory article 
we will look briefly at a simple C program. 
All the program does is to print a square 
of 'times tables' for 1 to 12. It is 
deliberately very contrived in order to 
illustrate as many features as possible. 
Figure 1 shows the listing. 


The first line of the program is a 
comment which simply serves to indicate 
what the program does, just like a REM in 
Basic. The second line is an instruction to 
include a header file containing standard 
function declarations, as described earlier. 
The name is in standard UNIX form, and 
the compiler turns it round to read h.stdio 
(file stdio in the directory h). 


The rest of the program consists of two 
function definitions. Like many 
languages, a C program is made up 
entirely of a set of functions. A point to 
note here is that there is no distinction 
between functions and procedures in C; 
the word function is used as a generic 
name regardless of whether it returns a 
result or not. 


All complete C programs must contain 
a function called main, and this is the 
function that is executed when the 
program is run (in effect the main 
function forms the body of the program). 


The first line of main states that it is a 
function, indicated by the brackets, and 
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/* 


Times table program */ 


#include <stdio.h> 


void printrow(int number) 


{ 


int count=1; 


while (count <= 12) { 


print£("$3d%c",count * number, count==12 ? ‘\n! 


count++; 
} 
} 


int main() 


{ 


int row; 


print£("THE TIMES TABLES\n\n") ; 

for (row=1; row!=13; row++) 
printrow (row) ; 

return 0; 


Figure 1. A sample C program 


that it returns an integer value. The body 
of the function is then enclosed within 
braces. The first line of the definition 
declares a variable called row which will 
be an integer. Next, the printf function is 
used to print a title. This function is built 
into the standard library, and its 
declaration was in the stdio.h header that 
was loaded. Literal text is enclosed in 
double quotes, and the sequence \n is 
used to indicate a new line. A second new 
line is used to provide a blank line 
between the heading and the table. We 
then have C's form of a FOR-NEXT loop. 
The statement roughly reads "row=1. 
While row doesn't equal 13, execute the 
following statement and increment row". 
The sequence != is C's notation for not 
equal to (<> in Basic), and ++ is an 
operator which means increment. The 
statement within the for loop is a call to 
our function printrow with the current 
row number as a parameter. The final 
statement in main is return. This is used 
to return a value from the function, in this 
case to RISC OS itself which interprets 
zero as meaning "executed OK". 


Looking now at the function printrow, 
its definition states that it takes a single 
integer parameter which will be called 


number, and returns nothing, 
as signified by the void. Again, 
an integer variable is declared, 
this time called count, but a 
value is assigned to it at the 
same time, namely one. The 
rest of the definition consists 
of a while loop which repeats 
as long as the value of count is 
less than or equal to twelve. 


ees 4 


Inside the loop we have 
another call to printf, this time 
with three parameters. The 
first is a print specifier, and 
says that we should print a 
decimal number in a three- 
digit field followed by a single 
character. The % symbol is 
used to distinguish specifiers 
like this from printable text. 
The number to print is the second 
parameter, and is simply the row number 
times the column count. The third 
parameter is the character to print after 
the number. This is determined using an 
interesting construct in C, namely, ‘a?b:c'. 
What this does is if the condition a is true, 
then the value of b is used, otherwise the 
value of c is used. In our example, if count 
= 12 then a new line is printed, otherwise 
a space. C uses == for comparison to 
distinguish between = for assignment. 
Finally in the while loop, the value of 
count is incremented. 


Don't worry if you didn't follow the 
program, it was only designed to give the 
general feel of a C program. Next month 
we look at the choice of C compilers and 
show how to get started once you have 
bought one. 


Both C compilers mentioned in this 
article are available from BEEBUG, 
priced as shown below. The higher prices 
in brackets are for non-members of RISC 
User or BEEBUG. 


Acorn ANSI C3 £162.78 (£171.35) 
Stock code 1085 

BEEBUG ISOC £79.00 (£89.00) 
Stock code 0107 
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Arc to Z88 


Lee Calcraft connects his Archimedes to a Z88 laptop. 


7. he Cambridge Computer Z88 laptop 

has long been a favourite with BBC 
micro users: its use of BBC Basic coupled 
with its very reasonable price, making it 
an ideal extension to the desk-bound 
Beeb. But what is true for the BBC micro 
is, in this case, also true for the 
Archimedes, And while the Archimedes 
version of Basic (Basic V) is more 
advanced than Z88 Basic, the differences 
are relatively few in number. Moreover, 
the Z88 comes with Colton Software’s 
Pipedream as standard (Pipedream 
combines a word processor, spreadsheet 
and database in a single package) - a fact 
which Archimedes Pipedream users will 
find extremely attractive. 


The Z88 in action 


THE SPEC 

Weighing just 2lb the Z88 is the size of 
an A4 notepad, and about one inch in 
thickness. It has a full qwerty keyboard 
with a “dead rubber” feel to it. And although 
the keys give little tactile feedback, it is 
possible to type at very good speeds on 
this machine. It runs from a set of four AA 
size batteries, which, it is claimed, will 
give some 20 hours of active computing, or 
will preserve data in the machine while it 
is switched off for about a year. 
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The machine, which uses a CMOS Z80 
processor, comes with 32K of RAM as 
standard, and houses three card slots 
which will take RAM packs (up to 512K) 
or EPROM packs (up to 128K). The price 
of these packs is typically half that of 
those for the Psion Organiser, reviewed 
last month, and much larger RAM packs 
are available for the Z88 than for the 
Psion, though unlike the Z88 the 
Organiser’s RAM packs have a built-in 
battery back-up which will maintain their 
data for up to two years. 


Compared to the Organiser, the Z88’s 
screen is massive. It has 8 lines which can 
hold over 100 characters each. The 
character set uses full descenders, and 
there are facilities to reverse out text, and 
also to make it feint. This latter feature is 
used to good effect when pop-downs are 
called (see later). On the down side, the 
blue supertwist screen of the Z88 is 
somewhat less clear than the standard 
grey/black LCD display of the Organiser. 


RESIDENT APPLICATIONS 

The Z88’s built-in software is excellent. 
It contains a healthy number of 
applications, including Basic, Pipedream, 
Calculator, Diary, Calendar, Clock, Alarm 
and Terminal. These may be selected from 
the central Index, or by using a special 
control key (with a square symbol). Thus 
Ctrl-P takes you to Pipedream, Ctrl-B to 
Basic, and so on. 


The Z88 also makes use of a pop-down 
system. The Filer (giving access to RAM 
files), the Index (a menu listing all 
applications), and the Calculator, Clock, 
Alarm and Calendar may each be popped 
down to overlay the current application. 
Thus, while in Basic, you can pop down 
the Filer to check what has been stored on 
the RAM disc, or the Calculator to carry 
out instantaneous calculations. 
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Additionally, all applications can be 
selected from a main Index, called using a 
dedicated key (called Index). If you call an 
application such as Basic from the Index, 
you enter Basic rather as if you had typed 
*BASIC on the Archimedes. Thus you see 
the language copyright message, and 
enter Basic with no current program in 
memory. But the Index has a second menu 
giving a list of suspended activities. By 
moving the cursor up and down this list, 
you can re-enter an activity, such as Basic 
or Pipedream, and continue where you left 
off. 


In fact you can maintain a large 
number of suspended tasks in this way, 
limited only by the RAM available. Thus 
you could be working on a Basic program, 
then call up the Index, and enter Basic 
again, and work on a second program. If 
you now return to the index you will see 
from the list of suspended activities that 
there are two entries for Basic (complete 
with date and time of last use). You can 
use the cursor keys to select which of 
these to work on next. And you can even 
interrupt running programs in this way 
(by pressing Index), returning at your 
leisure to the exact point where you left 
off. You can also switch off the machine 
(by pressing both Shift keys 
simultaneously), and at switch-on any 
task running will be reinstated at exactly 
the point where you left off. 


Z88 BASIC 

Z88 Basic is a close derivative of the 
version of BBC Basic available on the 
Z80 second processor for the BBC micro. 
The main differences from Archimedes 
Basic V are the lack of WHILE- 
ENDWHILE structure and CASE 
statement, the restriction of IF 
statements to a single line, and the 
inability of procedures and functions to 
make use of the RETURN keyword. Also 
there is no support for any of the 
Archimedes star commands or SYS calls. 
And as you might expect, the 
Archimedes’ graphics commands are not 


implemented. Even so, if you are familiar 
with Basic V on the Archimedes, 288 
programming will come as second nature. 


One snag with Z88 Basic is that there 
is no editing facility at all. If you wish to 
alter a line of Basic, you must completely 
retype it. There is however a patch 
written by the author of Z88 Basic which 
implements a line-by-line editing facility. 
Also implemented in the patch are a 
number of graphics options. A copy of the 
patch, together with documentation is 
supplied on this month’s magazine disc. 


A further slight inconvenience for 
those wishing to transfer Basic programs 
between Z88 and Arc is that although the 
two machines use compatible codes for 
storing Basic keywords, the first and third 
byte of each Basic line are transposed on 
the Z88. This month’s magazine disc also 
contains a short program called Convert, 
which runs on the Archimedes, and will 
convert program files in either direction. 


ARC TO Z88 

As suggested last month, the real 
power of a portable computer for an 
Archimedes user lies in the ability to 
transfer files between the two machines. 
This is obviously useful for backing up the 
288, since a battery failure in the machine 
would result in the loss of all files not 
consigned to EPROM. But the Z88 is 
excellent for entering even long screeds of 
text, while away from the desk-bound Are, 
for subsequent transfer. And of course, 
you can write programs for the Z88 using 
the superior development facilities offered 
by the Arc, and then transfer the 
developed program to the Z88 for 
operation in the field. And the same is 
true for text and other data loaded into 
Pipedream. 


The Z88 is supplied as standard with 
an RS 232 serial port using a 9 pin D 
connector. This makes communication 
with the Archimedes a relatively simple 
matter, and there are a number of 


RISC User June 1990 


Are to Z88 


products available to make file transfer 
quick and painless. The most 
sophisticated option involves using the 
Cambridge Computer Z88 PC Link pack, 
and software provided with the 
Archimedes version of Pipedream. You 
will also need a Z88 to Arc lead for this 
option, because the one supplied with the 
Link pack is not suitable for use with the 
Archimedes. 


i 
= 
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Figure 2. Using !Z88 


The PC Link pack plugs into one of 
the three slots beneath the Z88, and 
provides a new option on the Z88’s 
main index: Link. You simply select 
this option on the Z88, and then 
perform all further operations from 
the Archimedes’ Desktop. With the 
serial ports of the Arc and Z88 
connected, double-click on the !Z88 
icon on your Archimedes Pipedream 
disc, This installs a beautifully 
designed Z88 icon on the icon bar, 
which behaves like an additional 
disc drive. Clicking on this will open 
filer windows showing the files 
stored on the Z88. You can then 
double-click on these to run them, or 
drag them to other directory viewers 
to transfer them to the Arc. This 
process, which works in both 
directions, and for all types of files - 


A less sophisticated but much cheaper 
option is to purchase a Z88 to Archimedes 
transfer kit from BEEBUG. This contains 
a Z88 to Archimedes lead, and a 3.5 inch 
Archimedes disc. The latter provides 
software for transferring files, though 
without the ease of being able to drag 
them from the Desktop. Here you must 
use the Import-Export option on the Z88, 
and nominate files for transfer from the 
Z88’s keyboard (though you can use 
wildcards). 


Finally, for those as nimble with a 
soldering iron as they are at the keyboard, 
the budget option is to wire up a lead for 
yourself, and write the transfer software. 


This month’s magazine disc contains a 
copy of Convert for converting Basic 
programs between Z88 and Archimedes 
format; and Patch for providing program 
editing facilities on the Z88, and a limited 
graphics capability. 


If you would be interested in further 
articles on using the Z88 or the Psion 
Organiser with the Archimedes, please 
drop us a line. 


The following Z88 items are available from 
BEEBUG (prices include VAT): 


Z88 Computer 
Z88 Presentation pack 

(Z88, 128K RAM pack, 

Mains adaptor, Carrying Case) 
Z88 PC Link 


£219.99 
£273.76 


£34.10 
£307.35 


Z88 PC Link Pack 
(as Presentation Pack, 
but includes PC Link pack) 


£8.95 
£18.95 


Z88 to Archimedes lead 


Z88 to Archimedes Link kit 
(includes lead and Arc software) 


See BEEBUG Retail catalogue for other Z88 items. 


Cambridge Computer are on (0223) 
312216 RU 
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not just Pipedream files - is a delight to 
use. 
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MORE NEW RELEASES FROM DABS PRESS 


Z88 PipeDream: 
A Dabhand Guide 
from John Allen - expert Z88 journalist 


PipeDream, the builtin word processor, spread- 
sheet and database built into the Z88 is an ex- 
tremely powerful tool, and John Allen, author of 
many articles of the Z88, and experienced user 
has produced what must be the ultimate tutorial 
and reference work on the software. With many 


example documents and templates, this book 
takes you from first principles to a thorough 
understanding of the program. Linking to 
PipeDream on other machines such as the BBC 
and Archimedes is also covered. 


Only £14.95 all inclusive 
AVAILABLE 24th APRIL 


Also still available is our first book on the famous Cam- 
bridge portable marvel, Z88: A Dabhand Guide, written 
by Trinity Concepts, authors of the Z88 operating system. 
Also priced at £14.95 


THE LATEST DABHAND GUIDE 


We have moved! Please note our new address 
and telephone number for all correspondence. 


DABS PRESS (RUS) 
22 WARWICK STREET 
PRESTWICH 
MANCHESTER 
M25 7HN 

TEL: 061-773 8632 
FAX: 061-773 8290 


For personal callers Warwick St. is in the centre 
of Prestwich Village, just off Bury New Road. 


Dabs Press books and software are available 
from all good bookshops and Acorn dealers, or 
in case of difficulty direct from the above ad- 
dress. Access /Visa/ official orders accepted. Free 
catalogues on request. Prices include 15% VAT 
(on software) and UK postage. Foreign deduct 
VAT butadd £2.50 Europe/surface, £12 airmail. 


061-773 8632 


Cambridge Pascal 
isa comprehensive 
version of the Pas- 
cal language and 
includes many ex- 
tra enhancing fea- 
tures over the stan- 
dard specification 
including full dy- 
namic string han- 
dling, local error 
handling, random 
access files, direct 
access to ‘star’ com- 
mands and RISC 
OS SWI calls. It is 
100% Desktop 
compatible but can 
also be run from the command line. All programs compile 
into fast, efficient machine code. 

Cambridge Pascal requiresany Archimedes running RISC 
OS with at least IMb of RAM. Hard discs and extra 
memory are useful, but the system is perfectly workable 
with this minimum configuration. 

Price £79.95 (£69.52+VAT). Site licences available. Free 
demonstration disc and full specification sheet available 
on request. 


DEMO DISC FREE ON REQUEST 


CAMBRIDGE 
PASCAL 


Pull featured Pascal Compiler for the Acorn 
‘Archimedes 


ARCHIMEDES FIRST STEPS 
Beginners Guide to the 
Archimedes & BBC A3000 


This book is the perfect introductory guide to the 
Archimedes, to guide you through the first few months of 
ownership, acting as an easy-to-read supplement to the 
User Guide. 
The book describes in detail how to put the RISC OS Desk- 
top to best use, and also documents the programs on the 
Applications Discs provided with the machine. 
But the book also goes beyond this and describes the sort of 
software and hardware additions available to the 
Archimedes owner, and how to choose and install them. 
The many features of this book include: 
* Applicable to all Archimedes with RISC OS 
* Using the Desktop, RAMdisc and ADFS 
° Edit, Paint, Draw and Maestro 
© The Task Manager 
© The BBC and PC emulators 
¢ Hardware and software additions 
¢ Illustrated throughout 

AVAILABLE NOW! 


PRICE £9.95 
ONE OF OUR BEST SELLERS 


Watchdog Anti-Virus 


Protect both floppy and hard discs against viruses 


with Nick Smith’s utility. 


A corn’s computers have suffered less 
than others from the spread of computer 
viruses over the last few years, mainly as 
a result of their operating system being 
held in ROM, rather than on disc as is the 
case with MS-DOS, for example. However, 
it is perfectly possible for a virus to infect 
a floppy disc, which in turn can affect 
other discs. With a hard drive, the 
situation is potentially very serious 
indeed, and days, months, or even years of 
work could be wrecked: (hands up all those 
who have not backed up their hard drive 
recently....). 


WATCHDOG 

Help is now at hand with the 
Watchdog utility. Watchdog is installed on 
the icon bar, and when protect mode is 
selected, certain disc operations are 
inhibited, providing a kind of write-protect 
switch. Normal disc access, such as saving 
and deleting, is not prevented, since it 
would be a nuisance to have to turn the 
protection on and off during a work 
session. Two types of access are, however, 
prohibited: 


1) FileCore_DiscOp calls, which are 
often used by viruses to corrupt disc boot 
sectors, and by formatting code. 


2) OS_FSControl 27, which is used by 
the *Wipe command and can quickly 
remove all data from a hard disc or floppy. 


Any attempt to use these calls results 
in a “Protected disc” error. All ADFS 
drives in the system are protected, and so 
Watchdog is just as useful for floppies as 
for hard discs; do not assume that because 
you do not have a hard drive, you are 
immune from viruses. 


A further facility available with 
Watchdog is to “clean” a disc. This 
performs multiple *Compact commands 
until the call returns within 0.1 seconds, 
i.e. compaction has gone on as long as 
possible. This method is much better than 
using ADFS_FreeSpace until largest block 
= total space, since with E format discs, 
total compaction is rarely achieved. 
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Other programs exist which perform a 
similar operation, but where Watchdog 
differs is in wiping clean the empty part of 
the disc afterwards, thus killing any 
hidden viruses and overwriting old 
deleted data - you would be quite 
surprised how much confidential data, 
supposedly deleted, can sometimes be 
found on a disc! 


CREATING THE UTILITY 

The program is in two parts: a Basic 
application and a module, both of which 
must be present in the machine. Type in 
Listing 1 and save it as !RunImage in an 
application directory called !Watchdog. 
You will also need a !Run file as usual for 
a Wimp application, and a !Sprites file 
which must contain 2 sprites: !Watchdog 
and !Watchdog2. These will appear on the 
icon bar to signify that Watchdog is 
switched on or off respectively, so they 
should be similar in appearance, but with 
some indication of their different function. 
You could, for example, use the hard disc 
icon from the Wimp sprite pool, altering 
the red light on the front to black for 
!Watchdog2. See our Hints & Tips pages 
in Volume 3 Issue 1 for details on how to 
access the Wimp sprites. 


The !Run file must be an Obey file 
(created using Edit), and should contain 
the following lines: 


IconSprites <Obey$Dir>.!Sprites 

Set Watch$Dir <Obey$Dir> 

WimpSlot -min 16K -max 16K 

RMEnsure Watchdog 1.00 RMLoad<Watch$ 
Dir>.Watch 

RMEnsure Watchdog 1.00 Error Unable 
to find WatchDog module 

Run <Watch$Dir>. !RunImage 


Listing 2 is the source code for the 
WatchRM module which is used by 
Watchdog to implement its functions. Type 
the program in, save it then run it. The 
module code will be assembled and saved 
as a file called WatchRM. This file must 
be placed inside the !Watchdog directory. 
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USING WATCHDOG 

When Watchdog is first installed on 
the icon bar (left-hand side) the legend 
“Watch On” will be displayed, together 
with the sprite !Watchdog. Pressing Menu 
over the icon will show three options, 
Protect, Clean and Quit. Protect toggles 
between protection on and off - when the 
latter is selected, sprite !Watchdog?2 is 
displayed together with the legend “Watch 
Off”. Clean leads to a sub-menu which 
allows you to select drives 0, 4 or a 
number specified by the user. 


When you quit the application from 
the menu, protection is turned off. 
However, if you quit by exiting the 
Desktop (e.g. by pressing Ctrl-Shift-F12), 
protection is left on. This is because some 
programs exit from the Desktop before 
running, and would then be able to plant a 
virus if there were no protection. 


Even with Watchdog installed, this will 

not guarantee protection from viruses - 
that is just not possible - but it will help. 
It is still necessary for users to remain 
vigilant. 
There is an enhanced version of Watchdog 
on this month's magazine disc. This 
provides an extra option which protects 
your discs against all filing system write 
operations. 


Listing 1 
10 REM >!RunImage 
20 REM Program Anti-virus utility 
30 REM Version 1.00 
40 REM Author Nick Smith 


50 REM RISC User June 1990 
60 REM Program Subject to Copyright 
10: 
100 DIM blk% 512:DIM menu% 180 
110 DIM submenu% 120:DIM temps 64 
120 DIM spwork% 250:DIM buffer’ 40 
130 : 
140 PROCInitialise:PROCIconbar 
150 PROCCreate_SubMenu:PROCpoll 
160 END 
170: 
1000 DEF PROCpoll 
1010 mask%=%0 
1020 REPEAT 
1030 SYS "Wimp Poll", mask%, b1lk% TO eve 


ntCode% 

1040 CASE eventCode% OF 

1050 WHEN 2:SYS "Wimp OpenWindow", 0,blk 
% 

1060 WHEN 3:SYS "Wimp CloseWindow",0,b1 
ks 

1070 WHEN 6:IF blk%!8=2 AND blk%!12=-2 
PROCOpen_MainMenu 

1080 WHEN 9:PROCMenu_Selection 

1090 WHEN 17,18:IF blk%!16=0 finishedt= 
iz 

1100 ENDCASE 

1110 UNTIL finished’ 

1120 IF finished%=1 OSCLI "UnLock" 
1130 SYS "Wimp_CloseDown" 

1140 ENDPROC 

1150 : 

1160 DEF PROCMenu_Selection 

1170 LOCAL buttons’ 

1180 SYS "Wimp GetPointerInfo",0, tempt 
1190 buttons%=! (temp%+8 

1200 IF blk%!0=2 finishedt=1 

1210 IF blk%!0=0 PROCProtection 

1220 IF blk%!0=1 PROCClean 

1230 IF buttons%=1 PROCOpen_MainMenu 
1240 ENDPROC 

1250 : 

1260 DEF PROCProtection 

1270 IF protect’ THEN 

1280 protect %=FALSE 

1290 OSCLI "UnLock" 

1300 $(buffer%+30)="S!WatchDog2" 

1310 $(buffer%+20)="Watch Off" 

1320 ELSE 

1330 protect%=TRUE 

1340 OSCLI "Lock" 

1350 $(buffer%+30)="S!WatchDog" 

1360 $(buffer%+20)=" Watch On" 


1370 ENDIF 
1380 blk%!0=-2:b1k%!4=bar_handle% 
1390 b1k%!8=0:b1k%!12=0 


1400 SYS "Wimp SetIconState", , blk% 

1410 ENDPROC 

1420: 

1430 DEF PROCClean 

1440 IF blk%!4=0 SYS "Wimp StartTask"," 
Clean 0" 

1450 IF blk$!4=1 SYS "Wimp StartTask"," 
Clean 4" 

1460 IF blk%!4=2 THEN 
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1470 drive$=$buffers 
1480 SYS "Wimp StartTask","Clean "+driv 


1490 ENDIF 
1500 ENDPROC 


1520 DEF PROCOpen_MainMenu 

1530 LOCAL title$, item 

1540 title$="WatchDog": $menu%=title$ 
1550 menus?12=7 :menu%?13=2 

1560 menu%?14=7 :menu%?15=0 

1570 menus! 16=130:menus!20=44 

1580 menu%!24=0 

1590 items=menu$+28 

1600 IF protect? item$!0=1 ELSE item%!0 


1610 items! 4=0 
1620 item%!8=%1110000000010010000000100 


1630 $(item$+12)="Protect"+CHRS$ (0) 

1640 itemt=item%+24:items!0=%10 

1650 items! 4=submenus 

1660 item$!8=%1110000000010010000000100 


1670 $(item%+12)="Clean"+CHR$ (0) 

1680 items=item3+24:items!0=%10000000 
1690 item$!4=-1 

1700 items !8=%1110000000010010000000100 


1710 $(item$+12)="Quit"+CHRS (0) 

1720 SYS "Wimp _CreateMenu",0,menu%, (blk 
%!10)-130/2,44*6 + 32 

1730 ENDPROC 

1740 : 

1750 DEF PROCReport_Error(num%, text$) 
1760 blk%!0=num% 

1770 $(b1k%+4) =text$+CHRS (0) 

1780 SYS "Wimp _ReportError",b1k%,1, "Wat 
chDog" 

1790 ENDPROC 

1800 : 

1810 DEF PROCIconbar 

1820 $(buffer%+20)=" Watch On" 

1830 $(buffer$+30)="S!WatchDog" 

1840 b1k!0=-2:b1k%! 4=0 

1850 blk% 16:b1k%!12=148 

1860 blks!16=84 

1870 blk%!20=%1011100000000000000010000 
1011 

1880 blk%!24=buffer%+20 


1890 blk%! 28=buffer$+30:b1k%!32=10 

1900 SYS "Wimp CreateIcon",,blk% TO bar 
_handle% 

1910 ENDPROC 

1920 : 

1930 DEF PROCInitialise 

1940 LOCAL Wimp version’, task%,exist%,n 
extS 

1950 Wimp_version%=2 

1960 task$=&4B534154 

1970 SYS "Wimp _Initialise",Wimp version 
%*100, task’, "WatchDog" TO Wimp_version’ 
1980 IF Wimp_version%<200 PROCReport_Er 
ror(0, "WatchDog application requires a 
more recent version of the Window Manage 
r") 

1990 ON ERROR PROCError 

2000 finished’=FALSE 

2010 OSCLI "Lock" 

2020 protect %=TRUE 

2030 ENDPROC 

2040 : 

2050 DEF PROCError 

2060 IF ((ERR AND 255)<0) OR ((ERR AND 
255)>127) THEN 

2070 PROCReport_Error(0,"WatchDog Fatal 
error ~ "+REPORT$+" (internal code "+ST 
RSERL+", "+STRSERR+") ") 

2080 SYS "Wimp _C]oseDown":END 

2090 ELSE 

2100 PROCReport_Error(0,"WatchDog error 
"+REPORTS$+" (internal code "+STRSERL+ 
","+STRSERR+") ") :PROCpoll 

2110 ENDIF 

2120 ENDPROC 

2030: ¢ 

2140 DEF PROCCreate_SubMenu 

2150 LOCAL title$, items 

2160 title$="Clean":$submenut=title$ 
2170 submenu$?12=7 : submenu$?13=2 

2180 submenu%?14=7: submenu$?15=0 

2190 submenu’! 16=130: submenus !20=44 
2200 submenu’! 24=0:item$=submenus+28 
2210 item$!0=0:item$!4=-1 

2220 item!8=%1110000000010010000000100 
01 

2230 $(item%+12)="Drive 0"+CHR$ (0) 

2240 itemt=items+24:items!0=0 

2250 item’! 
2260 items !8=%1110000000010010000000100 


SSeS 
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01 
2270 $(item%+12)="Drive 4"+CHRS$ (0) 
2280 items=items+24 
2290 items! 0=%10000100:items!4=-1 
2300 items! 8=%1110000000010010001000100 
01 
2310 Sbuffer$="1"+CHR$ (0) 
2320 $(buffer%+10) ="A0-7"+CHRS (0) 
2330 item%!12=buffer’ 
2340 items!16=buffer%+10:items!20=2 
2350 ENDPROC 


Listing 2 
10 REM >MakeWatch 
20 REM Program Module source code 
30 REM Author Nick Smith 
40 REM Version 1.00 
50 REM RISC User June 1990 
60 REM Program Subject to Copyright 
10: 
100 MODE 0:DIM code% 2000 
110 pe=15:link=14:sp=13 
120 FOR pass%=4 TO 7 STEP 3 
130 P%=0:0%=code’ 
140 [OPT pass% 
150: 
160 EQUD 0:EQUD Initialise 
170 EQUD Finalise:EQUD 0 
180 EQUD Title:EQUD HelpText 
190 EQUD CommandTable 
200 : 
210 .Title 
220 EQUS "WatchDog":EQUB 0:ALIGN 
230 .HelpText 
240 EQUS "WatchDog"+CHR$(9)+"1.00 ("+M 
IDS (TIMES, 5,11)+") By Nick Smith"+CHR$0: 
ALIGN 
250 : 
260 .CommandTable 
270 FNcommand ("Lock", Lock, &£000000, Lock 
Syn, LockHlp) 
280 FNcommand ("UnLock", UnLock, 000000, 
UnLockSyn, UnLockH1p) 
290 FNcommand ("Clean",Clean, &010001,C1 
eanSyn, CleanHlp) 
300 EQUD 0 
310: 
320 .LockHlp EQUS "*Lock write-protect 
s all ADFS drives.":EQUB 13 
330 .LockSyn EQUS "Syntax: *Lock":EQUB 


O:ALIGN 

340 .UnLockHlp EQUS "*UnLock unlocks p 
reviously write-protected drives.":EQUB 
13 

350 .UnLockSyn EQUS "Syntax: *UnLock": 
EQUB 0:ALIGN 

360 .CleanHlp EQUS "*Clean wipes a spe 
cified ADFS drive clean of any hidden vi 
ruses or old data"+CHR$(13)+"that has be 
en deleted.":EQUB 13 

370 .CleanSyn EQUS "Syntax: *Clean <dr 
ive>":EQUB 0:ALIGN 

380 : 

390 .Lock 

400 STMFD (sp)!, {RO-R1, link) 

410 ADR RO,drives:MOV R1, #1 

420 STRB R1, [RO] 

430 LDMFD (sp) !, {RO-R1, pc} 

440: 
450 .UnLock 
460 STMFD (sp)!, {RO-R1, link} 
470 ADR RO,drives:MOV R1,#0 
480 STRB R1, [RO] 
490 LDMFD (sp)!, (RO-R1, pc} 
500 : 
510 .Clean 

520 STMFD (sp)!, {RO-R12, link} 

530 MOV R4,RO:MOV R1,RO:MOV RO, #10+ (1< 
<29) 

540 MOV R2,#7:SWI "OS_ReadUnsigned" 

550 ADR RO,clean_text:ADD R1,R2, #48 

560 STRB R1, [RO, #6] :ADR RO,oscli 

570 STRB R1, (RO, #8] :ADR RO, save_text 

580 STRB R1, [RO, #6] :ADR RO, compacting 

590 SWI "XOS_WriteO" 

600 .compact_loop SWI "OS ReadMonotoni 
cTime" 

610 MOV R3,RO:ADR RO,oscli:SWI "OS CLI 
" 

620 SWI "OS_ReadMonotonicTime" 

630 SUB RO,RO,#10:SWI &100+ASC".":CMP 
RO, R3 

640 BGT compact_loop:SWI "XOS_NewLine" 

650 ADR RO,cleaning:SWI "XOS_Write0" 

660 SWI "XOS_NewLine" 

670 .wipe_clean MOV RO,R4:SWI "ADFS Fr 
eeSpace" 

680 BIC R5,RO,#&FF:BIC R5,R0, #4300 

690 MOV RO, #&83:ADR R1,save text 

700 MOV R2,#0:SWI "OS Find": TEQ RO, #0 
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Watchdog Anti-Virus 


710 BEQ exit_clean:MOV R1,RO:MOV RO, #2 

720 .write_loop LDR R2,message:MOV R3, 
#1024 

730 SWI "XOS_GBPB":SWI "OS ReadEscapeS 
tate" 

740 BCS close:SUBS R5,R5,#1024:BNE wri 
te_loop 

750 .exit_clean ADR RO,clean_text 

760 SWI "XOS_WriteO":SWI "XOS_NewLine" 

770 .close MOV RO,#0:SWI "OS Find" 

780 .delete MOV RO,#6:ADR R1,save_text 
:SWI "OS File" 

790 LDMFD (sp) !,{RO-R12,pc} 

800 .clean_ text EQUS "Drive n is now c 
lean.":EQUB 0:ALIGN 

810 .oscli EQUS "Compact n":EQUB 0:ALI 
GN 

820 .save_text EQUS “adfs::n.$.nul()zz 
z":EQUB 0:ALIGN 

830 .compacting EQUS "Compacting. .":EQ 
UB O:ALIGN 

840 .cleaning EQUS "Now Cleaning.":EQU 
B 0:ALIGN 

850 .message EQUD &387FD44 

860 : 

870 Initialise 

880 STMFD (sp) !,{link}:MOV RO, #8:LDR R 
0, [RO] 

890 BIC RO, RO, #&FF000000:MOV RO, RO, LSL 
#2 

900 ADD RO,RO, #16:STR RO,instr:ADR RO, 
filter_SWI 

910 SUB RO,RO, #16:MOV RO,RO,LSR #2 

920 ORR RO, RO, #&EA000000:MOV R1,#8:STR 
RO, [R1] 

930 LDMFD (sp)!, {pc} 

940: 

950 .Finalise 

960 STMFD (sp)!,{link}:LDR RO, instr:SU 
B RO,RO, #16 

970 MOV RO,RO,LSR #2:ORR RO, RO, #&EA000 
000 

980 MOV R1,#8:STR RO, (R1]:LDMFD (sp)!, 
{pc} 

990 .instr EQUD &1F033C0 

1000 .drives EQUB 0 


&FC000003 

1050 LDR R11, [R12,#-4]:LDR R10,const:BI 
C R11,R11,R10 

1060 LDR R10,filecore:TEQ R11,R10:TEQNE 
R11, #&29 

1070 BEQ filter_op 

1080 .routine LDMFD R13!,{R10-R12}:LDR 
PC, instr 

1090 : 

1100 .filter_op 

1110 TEQ R11,#&29:BNE discop:TEQ RO, #27 
1120 BNE routine:BEQ jump 


* 1130 .discop AND R11,R1,#%1111:TEQ R11, 


#2 

1140 TEQNE R11,#4:BNE routine 

1150 .jump LDRB R12,drives:TEQ R12,#1 
1160 BNE routine;BIC R12,R14, #&4FC000003 
1170 LDR R11, [R12,#-4]:TST R11, #(1<<17) 
1180 BEQ generate error: LDMFD R13!, {R10 
-R12} 

1190 ADR RO,errBlock:ORRS R15,R14,#(1<< 
28) 

1200: 

1210 .generate_error 

1220 ADR RO,errBlock:MOV R1, #6 

1230 SWI "OS_ServiceCall":ADR RO, errBlo 
ck 

1240 MOV R9,#1:SWI "OS _CallaAVector" 
1250 LDMFD R13!,(R10-R12):MOVS PC, R14 
1260 .const EQUD &FFF20000 

1270 .filecore EQUD £40540 

1280 .errBlock EQUD &108C9 

1290 EQUS "Protected disc":EQUB 0:ALIGN 
1300 : 

1310 ) 

1320 NEXT pass% 

1330 name$="WatchRM" 

1340 SYS "OS File",10,name$, &FFA, , code’ 
10% 

1350 PRINT'"Module Saved as '"name$"'." 
' 

1360 END 

1370: 

1380 DEF FNcommand (com$, call, flags, synt 
ax, help) 

1390 [OPT pass% 


1010 : 1400 EQUS com$:EQUB 0:ALIGN 

1020 B filter_SWI 1410 EQUD call:EQUD flags 

1030 .filter_SWI 1420 EQUD syntax:EQUD help 

1040 STMFD R13!,{R10-R12}:BIC R12,R14,# 1430 ]:=0 RU 
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Ace Computing 


RISC OS Euclid is the best 


multi-tasking 3D graphics and calculating intermediate frames —_ Such is the enthusiasm for Euclid 
animation system for the from a set of key positions. there is now a user group called 
Archimedes. It works like a 3D Elements which provides a quarterly 


version of Draw, and now forms the Splice allows you to edit films —_gigk containing hints, tips, animations 
centrepiece for a number of related produced by Mogul or Tween. ang user pictures like the ones in this 


products allowing the creationof | You can even produce advertisement. 

complex animation sequences with hand-drawn cartoons by 

the minimum of effort. converting sprites from any Euclid £70 Mogul £20 Splice £30 
source. Tween £30 ArcLight £50 

Mogul makes full use of Euclid's Ace Computing, 27 Victoria Road, 

unique hierarchical data structure to Support is provided for import — Cambridge, CB4 3BW. 

generate films of 3D objects with and export of Sprites and Tel: (0223) 322559 

articulated motion and simultaneous Drawfiles. Films can be played —_ | prices include VAT and P&P. 

camera motion. by the Projector which comes : 


free with Euclid, Mogul, 
Tween produces films from Draw Splice and Tween. Films and 
files. It uses techniques similarto _ Euclid files can be used with 
Mogul and generates a film by Genesis. 


The A3000 Technical Reference Manual 


David Spencer looks at an Acorn publication aimed at the advanced user. 


A3000 Technical Reference Manual 
published by Acorn Computers Lid at £29.95 


For the advanced programmer of the 
A8000, the RISC OS Programmer's 
Reference Manual covers a lot of aspects of 
the operating system, but falls short on its 
coverage of the system hardware. This is 
where Acorn's new A3000 Technical 
Reference Manual comes into play. 


The book is presented in an A4 ring 
binder and consists of 37 pages of text and 
two plastic wallets. The wallets contain 
drawings of the main circuit board layout 
(two diagrams at Al size), together with 
the circuit diagram of the A38000, which 
consists of two AO-sized sheets. 


The text starts off with a brief 
description of the A8000 architecture, and 
then continues to look at the input/output 
system in detail. Some of the material 
here duplicates that in the RISC OS 
Programmer's Reference Manual, such as 
the memory maps, though there is new 
material, for example more details on 
accessing the IO Controller (IOC) and the 
interrupt system. There is a section 
devoted to how the keyboard is driven, 
and connections and specifications for the 
disc drive and power supply. There are 


Amiga Shock Horror: 
Fred Fish comes to Acornsville! 


STWPD are proud to announce 
that after an intensive bout of 
scrounging, they now have 859, 6, 
discs of Public Domain software 
for your favouurite Archimedes. 


| If you want a catalogue you can contact us at 
| the address below. Send a disc and SAE if you 


| want a free game and SoundTracker demo. 


STWPD, 12 Mornington Road, Radlett, 
Herts, WD7 7BL. (UK) 
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tables covering all the connectors and the 
various links that can be changed to alter 
the operation of the A3000, together with 
a complete parts list (in case you want to 
build your own?). Finally, there are some 
details of the expansion system. This 
section does not, however, explain how to 
design your own podules. This is instead 
covered in a document called A-Series 
Podules which can be downloaded from 
Acorn's SID database. 


The drawings at the back of the book 
cover case dimensions, internal expansion 
board detail, external expansion detail 
and overall assembly. There is also a 
circuit diagram for the Midi/IO Card. 


CONCLUSION 

Is it worth buying? I am sure that the 
majority of A3000 users will find this book 
of no use whatsoever. However, I am sure 
some people will buy it, either because 
they really need the information it 
contains, or because they just want to find 
out more about their A3000s. Either way, 
this is definitely a technical book for 
technically minded people - it contains no 
user friendly chit-chat. RU 


ADVERTISING 
IN 
RISC USER 


Please contact Sarah Shrive for 
advertising in RISC User magazine 


TEL: (0727) 40303 
or 
FAX: (0727) 60263 


or write to: 
BEEBUG Ltd, 117 Hatfield Road, St 
Albans, Herts. AL1 4JS 


16 bit SCSI 


Oak's high speed 16 bit SCSI 
podule offers a new level of 
performance for the entire 
| ‘Archimedes range (including 
the A3000) with data transfer 
rates of up to 14Mb per second, a considerable increase over 
both S506 and8 bit SCSI controllers. Up to 2 Gigabytes of 
winchester storage may be fitted per machine, and seven SCSI 
devices including 4 winchesters may be attached to the card. 


The card provides a new filing system 

‘SCSIFS', and an icon and filer for the - 

Risc OS desktop. It can work in tandem il 

with ADFS winchesters, and is compatible i 

with the PC emulator. Low level (SW1) 

support is provided for other SCSI devices SC SI 4 
(e.g. tape streamers, CD ROMS etc.) 


Internal winchester kits are supplied as ‘plug in and go' units, 
with all necessary cabling and mounting hardware, and external 
drives are supplied in sturdy metal cases, colour matched to the 
Archimedes, and have their own power supply and fan. External 
drives are also suitable for the A3000. 


Acomprehensive manual with easy to follow fitting instructions 
is provided with each system, along with a versatile formatting 
and utility program. Oak SCSI drives may be write protected for 
security. 


All Oak SCSI winchester drives are || = 

subjected to rigorous quality control 

procedures, and each drive comes 8 

with its own test certificate. 

Internal Drives (inc SCSI card) External Drives (ne SCSI card 
20Mb (HDINARC20SC) £375.00 20Mb (HDEXARC20SC) £535.00 
45Mb (HDINARCASSC) £495.00 45Mb (HDEXARCISSC) £655.00 
80Mb (HDINARCEDSC) £795.00 SOMb(HDEXARC#ASC) £955.00 
100Mb(HDINARCIO0SC) £114.00 100Mb (HDBXARCIOOSC) £1274.00 
200M (HDINARC2OUSC) £1458.00 200Mb (HDEXARC200SC) £1618.00 
SCSI Card (SCSIARC) £199.00 300Mb (HDEXARCI00SC) £2845.00 
SCSI Card (SCS13000) £199.00 S12Mb (HDEXARCSI2SC) £4085.00 
‘P&P internal drivesicard £10.00 P&P external drives £15.00 


16 bit SCSI Controller Card and 
High Speed Winchester Drives 


Tape Backup 


Oak SCSI tape streamers, 
available in 60Mb and 
1S0Mb capacities are the 
ideal means of backing up 
large amounts of data. 
Using ‘DC600" type data 
cartridges and high quality 
tape drive units, Oak tape 
streamers provide a 
reliable insurance against 
data loss. Multi-tasking, 
window software allows 
information to be backed 
up from any Archimedes 
filing system. Restoring 
data from tape is simple. A 
tree viewer of the directory 
structure stored on the 
tape, or a ‘filer’ type 
display can be shown in a window, and then the files to be 
restored can be simply ‘dragged’ with the mouse to the 
destination filing system, or even into an application! 


Unattended backups may be triggered on a regular basis using 
the inbuilt automatic 

backup facility. 

Prompts to prevent 

accidental 

overwriting of 

existing files may be 

given during a 

restore as required. \Limues 

Note: An Oak SCSI controller card is required. Drives are 
supplied with I free tape cartridge. 


Tape Streamers 
60Mb without SCSI card (TS60SCA) £999.95 
60 Mb with SCSI card (TS60SC) £109.95 
150Mb without SCSI card (TSISOSCA) £1254.00 
1S0Mb with SCSI card (TSISOSC) —£1354.00 
P&P on Tape Streamers £15.00 
60Mb Tape Cartridge £24.95 
150Mb Tape Cartridge £2795 
P&P on Tape Cartridges £0.75 


SCSI Tape Streamer 


New Products 


Gigabyte Tape Streamer 


For those requiring vast amounts of storage for archiving of 
data, the new Oak Gigabyte Tape Streamers offer the ideal 
solution. Storing 1 Gb of data on a single Digital Audio Tape 
cassette, these SCSI devices provide exceptionally reliable bulk 
data storage with low media cost, The tapes are accessed using 
our Risc OS Tape Backup software described in the Tape 
Backup column. Front panel controls and an LCD display allow 
access to facilities such as tape formatting etc. which may be 
performed off-line i.e. without tying up the computer. 

1Gb Tape Drive (TSGIGA) £3999 (p&p £15) 
IGb Cassette (TAPE1000) £35 (p&p £0.75) 


Magneto-Optical Drive 


The very latest technology in mass storage. Oak Magneto- 
Optical drives store 560Mb of data on 5.25" optical media. The 
drives are random access devices and behave as winchesters 
under the SCSI filing system. Data may be written, read and 
erased at will. The data cartridges are removable, looking 
similar to compact discs, and are extremely rugged. They are 
double sided with 280Mb of storage per surface. 
Magneto-Optical Drive (MAGOPTS60) £4800 (p&p £15) 
Data Cartridge (MAGOPTDISC) £300 (p&p £0.75) 


A3000 Monitor Bridge 


A sturdy unit which bridges the A3000 whilst still allowing 
access to the mains switch, disc drive and reset button, The 

bridge is of steel construction and is finished in a robust powder 
coat paint finish coloured to match the A3000. 


Monitor Bridge (MSBO1) £19.85 (p&p £3) 


——— Oak 
> Cross Park House BY 
9 Low Green = 
SSS Rawdon Government 
———— Leeds Orders 


TN] LS19 6HA Accepted 
Tel: 0532502615 lll prices exclude 
Fax: 0532 506868 VAT. 


by Lee Calcraft 


1 are many occasions when a 
program needs to detect not just the 
normal range of alphanumeric keys on the 
Arc’s keyboard, but some of the more 
esoteric ones such as the function keys, 
Page Up and Down, Insert :and so on. In 
order to do this you need to issue one or 
more *FX calls to tell the operating 
system that you wish such keys to return 
ASCII values when pressed. 
By default of course, the KEYS 
function keys return any | print (Fo) 
string which is programmed Fi 

into them, while the cursor F2 
keys initiate Copy key 
editing. FS 
Fé 
The way in which the FX F7 


calls work is a little FB 
involved (see below), but the F9 
accompanying program uses | +, 
ten calls to program the Arc 
to return a different code for 
each key on the keyboard. 
Once these calls have been 
issued, the values returned 
by the keys (and detectable 
using the statement 
A%=GET) are as given in 
table 1. 


Copy 
Cursor-Left 


Cursor-Right 
Cursor-Down 
Cursor-Up 


Page-Down 
Page-Up 


F10 
Fit 
F12 
Insert 


If you run the program it 
will issue the appropriate 
FX calls, and then display 
the number in decimal and 
hex returned by each key 
that you press. You should 
see that each key returns 
the value listed in the table. 
Moreover, the values 
returned by each key when 
used in conjunction with the 
Shift and Ctrl keys, and 
with Shift-Ctrl are also all unique. With 
Shift, each key will return a value 16 
greater than that listed. With Ctrl it will 


Delete 
Backspace 
Home 
Space 
Return 
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Table 1. The values 
returned by each key after 
Issuing the *FX calls listed 


Exploiting the Arc's Keyboard 


be 32 greater, and with Shift and Ctrl 
both pressed, it will be 48 greater. The 
only exception to this is the group of five 
keys at the bottom of the table, which 
return values unaffected by use of Shift or 
Ctl. 


If you are going to use this technique 
in a program, you will need to use the 
ten FX calls as listed, but 
you will also need an 
error handler similar to 
that in PROCerror. The 
purpose of this is to reset 
the keys to their default 
assignments once the 
program has terminated. 
And if the user can quit 
your program without 
pressing Escape, you will 
need to reset the machine 
at the end of the program 
too, using the same FX 


calls as used in 
PROCerror. 

142 

is THE ESCAPE KEY 


158 The listed program 


459 does not attempt to 
reprogram the Escape key, 

202 but if you issue: 

203 *FX 220,n 


204 


205 then the Escape and 


Break keys will return the 
127 value 27, but will not 
8 interrupt the program. 
30 This action is taken over 
= by the key (or keys) which 
generate the value n. If 
n=0, then to generate an 
Escape, you will need to 
press Ctrl-@ (which 
generates an ASCII value 
of zero). Alternatively, you can use *FX 
200,1 to disable Escape entirely (*FX 200 
will restore it). 
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Ekploiting the Arc's Keyboard 
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TECHNICAL NOTES 

The *FX calls in the range *FX 221- 
228 program the way in which buffer 
codes in a particular range are treated by 
the operating system. This is dealt with 
in the Programmer’s Reference Manual 
page 519 (see also RISC User Volume 2 
Issue 6 page 40). The easiest way to 
approach this is to see it in terms of the 
function keys. *FX 225,n determines how 
the function keys 0 to 9 will behave. If 
n=0 the keys are disabled, if n=1 the keys 
are expanded as normal function keys, if 
n=2 the keys return a special two-byte 
code, while values between 3 and 255 are 
treated as a base, and supply the value 
returned by the sequence of keys. We 
have used: 

*FX 225,128 
This sets function keys 0 to 9 to return a 
key value with base 128. Thus Print (FO) 
returns 128, Fl returns 129 and so on. If 
we had used *FX 225,1 (the default) then 
the keys would return their expanded 
strings (i.e. whatever the user had 
programmed into them). 


*FX 226,n works in a similar way 
when the function keys FO-F9 are used in 
conjunction with Shift; *FX 227,n 
determines the effect of Ctrl; and *FX 
228,n of Ctrl-Shift. 


FX calls in the range *FX 221-224 
work in a similar way for function keys 
F10-F12, but are a little more complex to 
comprehend in that the base value falls 
not at F10, but at a value 10 lower. Thus 
using: 

*FX 221,192 
sets F10 to return not 192, but 202 - 
however, the principle is the same. 


There are two *FX calls used in the 
program that we have not mentioned: 
*FX 4,2 (not *FX 4,1, note) and *FX 219,138. 
The first alters the way in which the 
Cursor and Copy keys work so that they 
will return the required ASCII values 
when used in conjunction with the other 


*FX calls (and is cancelled with *FX 4), 
while the second individually assigns a 
value to the Tab key. I have used a key 
value of 138 so that Tab can return a 
unique value; and indeed Shift-Tab, Ctrl- 
Tab and even Shift-Ctrl-Tab all return 
unique values (just add 16, 32 or 48 to 
the original value, as with the function 
keys). 


10 REM >KeyTest1 

20 REM by Lee Calcraft 

30: 

40 ON ERROR PROCerror:END 

50 *FX 4,2 

60 *FX 225,128 

70 *FX 226,144 

80 *FX 227,160 

90 *FX 228,176 

100 *FX 221,192 

110 *FX 222,208 

120 *FX 223,224 

130 *FX 224,240 

140 *FX 219,138 

150 CLS 

160 PRINTTAB(10,10)"Key tester" 
170 PRINT TAB(10,14)"Press a key" 
180 REPEAT 

190 A%=GET 

200 PRINT TAB(10,16)"Value returned 

= "FAR" (&";~AS") ";SPC (6); 

210 SOUND 1,-10,70,1 

220 UNTIL FALSE 

230 END 

240 : 

250 DEFPROCerror 

260 PRINTREPORTS" at line ";ERL 
270 *FX 4 

280 *FX 221,1 

290 *FX 222,208 

300 *FX 223,224 

310 *FX 224,240 

320 *FX 225,1 

330 *FX 226,128 

340 *FX 227,144 

350 *FX 228,0 

360 *FX 219,9 
370 ENDPROC AW 
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Outputting Archimedes Files 


By Mike McNamara 


n the Archimedes RISC OS Extras 
disc you will find a printer driver for 
PostScript laser printers - /PrinterPS. If 
you have such a printer, then this will 
enable you to produce very high quality 
printed output from virtually any of the 
applications running under RISC OS. 
However, I wouldn’t expect to find too 
many Archimedes owners with their own 
PostScript laser printers! But, many of 
you may have access to such a printer at 
work (or through a friend), which is 
running from an IBM or compatible PC. If 
this is the case then the following item 
may well be of interest. 


Using the PostScript printer driver, 
you can create PostScript files on disc 
from any suitable RISC OS application, 
such as Draw, or BEEBUG’s new DTP 
package Ovation. You can then use the PC 
emulator to transfer the file to a DOS 
format disc for subsequent printing on a 
PC with PostScript printer attached. 


STAGE 1 

Install /PrinterPS, and then, using the 
Menu button, click on the driver icon. 
Select the ‘File’ option and enter an 
appropriate filename. This will create a 
PostScript output file on disc. Now output 
your document, or whatever, in the 
normal way by dragging the relevant file 
to the printer driver icon on the icon bar 
(or by using the relevant print option from 
within the application). Instead of going to 
an actual printer the output will be sent 
to the disc file created, and will consist of 


the PostScript language description of the” 


material being printed. 


STAGE 2 

Since the final printing is going to be 
through a DOS compatible machine, you 
now need to transfer this PostScript file to 
a DOS format disc. For this you will need 
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to a PC’s Laser Printer 


the PC emulator. Once in the emulator 
you have access to a utility called 
GETFILE.EXE which will copy a file from 
an Acorn ADFS format dise to a DOS 
format disc: 

GETFILE <ADFS source> <DOS 
destination> For example: 

GETFILE :1.FRED A:\FRED.TXT 
For this you ideally need access to two 
drives (though it can be done with one 
drive if you take care when swapping 
discs). If you only have the one then you 
will need to set up a RAMdrive within 
DOS. Add the following line to the 
CONFIG.SYS file: 

DEVICE=RAMDRIVE xxx 
where xxx is size of the RAMdrive in K. 
Your RAMdrive will be given as Drive C: 
and you must remember to copy any files 
transferred to it to a real disc before you 
leave the emulator. You will also need to 
copy the GETFILE.EXE file to the 
RAMdrive, since your ADFS disc will need 
to go in the Archimedes disc drive. 


STAGE 3 

You are now ready to take your DOS 
disc, containing a copy of the PostScript 
file output from the Archimedes, to your 
nearest PC PostScript laser printer. Once 
you have ensured that the printer is in 
PostScript mode, and all is ready you 
simply enter the DOS command: 

COPY <filename> LPT1: 

or: COPY <filename> COM1: 


Use LPT1: if the printer is connected 
via a parallel interface, and COM1: if 
serial. If the system is on a network then 
you will need to find out which port is 
being used for the printer (LPT1: on the 
Novell network I use). You should now 
have a beautiful laser printout of your 
original, Archimedes produced, material, 
and the only item you had to carry to work 
was the disc! RU 
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<4 ARMs UPGRADE X1 


Aleph One Limited Aleph One Limited 


The Aleph One Limited ARM3 Upgrade propels the Acorn Archimedes range to give 
a phenomenal 10-12 MIPS (Million Instructions per Second). Acorn Computers' own 
VLSI Design Team has engineered this latest ARM processor to give performance 
on a par with top class workstations - based on the same ARM2 processor core 
already used in the Archimedes, ARM3 is machine-code compatible yet typically 
runs THREE times faster! Here's what some ARMS users and reviewers have had 
to say... 


"Really, it is not a question of whether you can afford to upgrade, you should 
ask yourself if you can afford not to!" 
Paul Fellows, A&B Computing. 
"Time is money. You value your time, you buy the product." 


Roger Howarth, BBC Acorn User. 
"Our 1024-point fast Fourier transforms used to take about 150ms; now we 
can do them in 50ms, so we see them in real time." 
A user in the MoD. 
"I am writing to congratulate you on your excellent ARM3 Upgrade..." 


Dr. Colin Dean, Cambridge. 
"The overall speed improvement was no less than 12.6 times - avery 
significant increase - and produced [1 to 300 terms in I second." 


Mr G H Foot, Oxted. 


".., an Archimedes fitted with an ARM3 is still an inexpensive way to buy the 
15 to 20 MIPS it offers on many programs." 


Dick Pountain, BYTE Magazine. 


When running the C Dhrystone benchmark from the Desktop in mode 12 the ARM3 
cache improves the performance from 4630 to 15480 dhrystones per second, a ratio 
of 3.4. Many BASIC or machine code programs will be sped up more than this - the 
improvement is highly dependent on the task being done and the screen mode. For 
detailed information on performance please write or ‘phone us. 

The fine print... Two speeds of ARM3 Upgrade are available, with clock rates of 20MHz and 30MHz. A 30MHz 
upgrade costs £595 + VAT (RRP). The 20MHz upgrade costs £495 +VAT (RRP). The 20MHz upgrade is only sold 
direct from Aleph One Ltd. - please call for availability. The Upgrade can be fitted to A310 & A440 models with the 


addition of a MEMCi1a upgrade, and directly to A410, A420, A440/1 and R140 models. Available from all good 
dealers or directly from us. 


For details contact: 
Aleph One Ltd. The Old Courthouse, Bottisham, CAMBRIDGE, CB5 9BA. 
Telephone (0223) 811679 Facsimile (0223) 812713 


Scanners for the Arc 


Mark Sealey reviews three scanning devices for the Archimedes range. 


I seems to be a feature of the 
Archimedes range that certain product 
which were previously missing from the 
catalogues suddenly proliferate. Now, and 
within a few weeks of one another, four 
separate scanners have been released. 
There is a fifth (by Irlam), but it is 
essentially aimed at the professional 
market as is reflected by its features and 
much higher price. 


One of the scanners now available to 
the potential purchaser is BEEBUG’s own 
Scavenger. However, as part of the 
established policy to ensure fair and equal 
treatment for all, the BEEBUG scanner 
does not form part of this comparative 
review. The three other low-cost packages 
to choose from are: technoScan (by 
Technomatic), Scanlight (Computer 
Concepts) and Archi Hand Scanner 
(Watford Electronics), 


In general this type of peripheral 
permits images (colour and monochrome 
as well as text) to be “read” into the 
computer’s RAM for later incorporation 
into DTP artwork, page layouts, etc. Such 
scanned images, in the form of sprites, can 
also be loaded into a variety of graphics 
packages for further enhancement. The 
scanner is a compact and lightweight 
table-top device which optically scans the 
surface as it is moved over it at between 1 
and 2 centimetres per second. Each of the 
systems reviewed here has supporting 
software (usually in ROM on the 
associated interface card) and a manual. 


Scanlight Junior - to give it its full name - 
is also available in an A4 version for 
which there is an optional sheet feeder to 
automate the scanning process. 


HARDWARE 

The scanners reviewed here are all 
hand-held devices, about twice the width 
(at their broadest point) and rather longer 
than a standard Archimedes mouse. The 
area they will scan is about 4” across and 
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as deep as computer memory will allow. If 
your source material is as wide even as 
the two columns of, say, Risc User then 
check: this may be a real restriction for 
you, necessitating an A4 version. 


The products of all three companies are 
based on the GeniScan Taiwanese unit, 
which illuminates the document surface to 
be read with a red or preferably 
yellow/green light source, and then reading 
the reflection returned to it through a 
narrow opening on the forward base of the 
scanner. Hence certain colours can tend to 
show up poorly, if at all. A way around this 
can usually be found by scanning a good 
photocopy of the original image. The 
scanner is normally moved slowly towards 
the user over the material to be scanned. 


A rubber roller rests on the paper 
surface, and the software indicates (see 
below) if you are moving the unit too 
slowly or too quickly. In practice there is 
little to choose between each of the three 
scanners reviewed here, though the 
Watford model also has two small wheels 
near the back, which adds to the sense of 
stability. There is nothing else to guide 
your hand over the surface to be scanned, 
and it takes a little practice to achieve a 
good quality scan. Be assured, though, 
that some very pleasing and eminently 
usable results can consistently be 
achieved with all three packages. 


Each of the scanners also requires a half- 
width expansion card to be fitted. Again, 
there is little to choose between the three 
contenders. technoScan additionally requires 
a flying lead to be attached in-line to the 
backplane. Scanlight is only guaranteed to 
work in podule sockets 0 and 2. 


Although different in design, the 
expansion cards appear to be of uniformly 
good construction, and each performed well 
during review. The three packages differ at 
this point in that technoScan has its 
software on disc, whereas the Watford 
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Electronics and Computer Concepts 
products use ROM-based software on the 
expansion card. In each case the software 
controls the scanner itself, and subsequent 
image manipulation. In practice, so little 
memory is taken up by the disc-based 
software that this is no drawback. 


Immedivtely an tap af a 
the collecting tray for pr 


only a fraction of 

+ mere 14 Th (the 
sevihes 

requires © minimum of 


Scanned Image using technoScan 


All three scanners have leads of ample 
length to connect them to the interface 
cards. Controls are kept to a minimum: all 
have a start-scan button, a thumbwheel for 
setting the contrast, and one to select 
either photo (3 modes) or letter (just 1); 
the technoScan and Archi Hand 
Scanner also have a slider for control of 
resolution - an addition planned by 
Computer Concepts, but not imple- 
mented on the unit sent for review. 
Each model was robust and easy to use, 
the Watford model perhaps having a 
marginally more “solid” feel to it. 


The results offered here for 
comparison are of sprites, which were 
all scanned with the “photo” setting at 
400 dpi, and with the brightness 
control set just less than maximum. It 
would be unwise to draw too many 
conclusions from these as slight 
variations in settings can alter the 
end appearance considerably. You may be 
sure that whichever unit you eventually 
choose will give more than passable 
results. Thus some other criteria are 
needed to judge the superiority or 
otherwise of these products. 


SOFTWARE 

Each of the scanners will produce an 
image of from 100 to 400 dots per inch. In 
general the higher the resolution, of course, 
the greater the amount of memory needed 
(up to about half a Megabyte), but the better 
the picture quality. The software itself does 
three things: it looks after operations 
affecting the scanning, it handles the filing 
and printing of an image, and it allows it to 
be edited and manipulated once scanned. 


Since sprites can be sent to the Paint 
application and modified there, it would 
hardly be a real disadvantage if any of the 
three failed to provide graphic editing 
facilities. In fact all the packages support 
cropping, zooming, and X and Y flipping, 
as well as scaling; with Technomatic’s 
being slightly the more extensive. 


Computer Concepts’ menus are similar 
in style to the plinths which figure in the 
Impression DTP package; as such they are 
not fully consistent with the RISC OS 
Desktop. Neither is the Scanlight Wimp 
environment itself. The version sent for 
review was not as robust in several ways 
as it might have been, either. 

Tre Hewlett-Packard Deskiet Plus Immediately on top of 
ink jet technology to obtain for 
lity approaching that of the ¥ 
laser printer, Yot it costa only a fraction of 
the price, weighs « mere 14 Ib (the 
Panasonic KX-P4450 laser printer woighs 


56 Ib), and requires 4 minimum of 
maintenance. 


and then drops it onto 
(face up in reverse ord 


The reason for th 
prosumably to previ 
bi 


graphics 
noticeably di 
some aigas| 
wrinkling of f 


, i though | 
‘Scanned Image using ScanLight Junior 


The menus and dialogue boxes of Archi 
Hand Scanner and technoScan are true 
Riscware, as the style is coming to be called. 
This must be counted an advantage. 


The Technomatic and Watford systems 
differ from Computer Concepts’ in that a 
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scanner icon installs itself on the Desktop 
icon bar, to the right of the filing system 
icons, and operation is controlled entirely 
from there. In fact, control of the Archi Hand 
Scanner is delightfully simple, even the 
Colourtrans module being installed for you. 
The firmware also remote-detects which 
resolution has been set on the scanner. 


Inmedustely en top of 
the collecting tray for 
hie latter uaex m mec] 
each omergtog #hoek unt: 
and then drepé it 204s 
Panaionie KX-14450 huve printer weighs Gace up in reverse arde 
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owiintsnanee, 


Scanned image using Archi Hand Scanner 


Personal preference nevertheless 
dictates that the technoScan software - 
because of its ease of use and logical design 
- is marginally superior to the others. Here 
the menus behave in a strictly hierarchical 
fashion. The other software sometimes 
achieves different effects by clicking in 
different places on the screen. technoScan’s 
single top-level menu gives you a greater 
feeling that you are the boss. 


DOCUMENTATION 

The style chosen by each of the 
manufacturers for accompanying 
documentation is the A5 booklet, all but 
Watford Electronics’ being ring bound. 
Watford’s is also the sparsest for actual 
operating instructions, the whole thing 
being only ten pages long, where the 
others are in excess of forty. The most 
comprehensive in terms of the three 
reviewed here is technoScan’s, which is 
organised around the menus themselves. 


CONCLUSIONS 

There really is very little to choose 
between these excellent products. Each 
does the job of reading into the computer 
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an image from a flat surface extremely 
well. So something else has to be found to 
enable any recommendation to be made. 


The obvious one is price. On these 
grounds the two front runners have to be 
those products from Watford Electronics 
and Technomatic which are each cheaper 
than Computer Concepts’ by some £30. 


Alternatively, the degree of feedback 
about scan speed might be considered 
important. This is because experience and 
practice are the only reliable ways of moving 
the scanner over the surface without leaving 
gaps or letting the image slip sideways. 
technoScan and Scanlight change the 
display (window borders) on screen while 
the Archi Hand Scanner also gives an 
audible and visual warning where you are 
more likely to be looking - on the scanner 
unit itself. This is a better arrangement. 


Lastly, the variety of image types that 
can be saved for re-use may be important 
to you. The Technomatic and Watford 
Electronics software will permit saving as 
a sprite only, whereas Scanlight supports 
file compression, thus saving disc space, 
and even allows images to be saved in a 
format suitable for sending as a fax. 


So, the choice in the end has to be a 
personal one: something in the foregoing 
might exclude or recommend one or other of 
the models on offer. If not, then for software 
features, reliability and consistency with 
RISC OS it may be that technoScan just has 
the edge. 


Product 
Supplier 


Archi Hand Scanner 

Watford Electronics 

Jessa House, 

250 High St, Watford WD1 2AN. 
Tel. (0923) 37774 

£171.35 Inc. VAT 


ScanLight Junior 

Computer Concepts 

Gaddesden Place, 

Hemel Hempstead, Herts HP2 6EX, 
Tel. (0442) 63933 

£202.85 Inc. VAT 


Price 
Product 


Price 


Product 
Supplier 


TechnoScan 

Technomatic 

Techno House, 

468 Church Lane, London NW9 8TQ. 
Tel. 081-205 9558 


Price £171.35 Inc. VAT 
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SCAVENGER 


The BEEBUG scanner, called 
Scavenger, is a similar device to those 
reviewed here. It is available in a hand- 
held version switchable between 100, 200, 
300 and 400 dots per inch, and a 200 dpi 
A4 model with optional sheetfeeder. The 
package is supplied complete with a half- 
width interface card which contains all 
the software on ROM. Images can be 
scanned as text or photographs, converted 
to grey shades if desired, and transferred 
either to Paint for further editing, or 
directly into any application that accepts 
sprites. Images can also be saved in a 
compressed format to save disc space. The 


Scavenger documentation consists of a 
fifty-page wire-bound user guide which 
includes full installation and user 
instructions together with a technical 
reference section for advanced users. 


A version of Scavenger for the A3000 
will be available shortly, including a boxed 
interface card and external power supply. 
A colour image scanner is also planned. 


Product Scavenger 
Supplier BEEBUG, 
117 Hatfleld Road, 
St Albans, Herts AL1 4JS. 
Tal. (0727) 40303 
Price £194.00 Inc. VAT (members’ price) 


RU 


- THE Archie 
art package! 


HERE'S WHAT IT CAN DO: 
* Over 32,000 colours available 

* Shadow/ Highlight brush 

* Very easy to use 

* Used in education round the country 

* Compressed screens 

* Runs in the RISC OS desktop 

* + lots more FOR ONLY £19.99! 


NEW! DESKTOP C 


* Use Acorn C (rel. 3) under the desktop! 
* Use cc, link, make, etc. at a mouse click 
* Other utils including Deluxe backdrop 
* Optimised for Imbyte machines 

* Send a SAE for full details 

* All this for only £14.99 


From: Silica Software Systems, Mallards, Lower Hardres, Canterbury, Kent, CT4 5NU 


RISC User June 1990 


BEEBUG SCAVENGER 


The Beebug Scavenger image scanner adds life to Desktop 

2 ns 4 5 a he Hewlett-Packard DeskJet Plus Immediately on top of 
Publishing, Word Processing, Drawing and Painting, and many |} printer uses ink jet technology to obtain the collecting tray for ) 
other activities. Just some of the possible uses are: yutput quality approaching that of the This latter uses a meci 


laser printer. Yet it costs only a fraction of each emerging sheet until 

fe = the price, weighs a mere 14 Ib (the and then drops it onto 

* Incorporating photographs and drawings into text documents. |} Panasonic KX-P4450 laser printer weighs (face up in reverse order 
+ . . . 56 Ib), and requires a minimum of The reason for the « 

® Scanning pictures to use them as templates for line drawings. 

© Creating artwork for exciting title screens. 

* Scanning photos and text to make a graphical database. 


maintenance. presumably to prevent i) 
being smu 
arrival of t 
have to 

experionced 
during tests 
graphics 


Scavenger consists noticeably da 
some signs 


of a professional 
quality scanner,a Him SCAVENGER “Sa wrinkling of t 


, . The Desk 
half-width interface : a ~ both serial 
interfaces, a 

a - . : 


card,anda 

comprehensive user edes 
guide covering 
installation, use, 
hints and tips, 
technical 
information and 
routine maintenance.| 


Variable image size, with the 
maximum width being limited by 
the scanner, and the depth limited 
only by the available memory. 

Real-time display into a window 


Scavenger is as the image is scanned. 

available with two different scanners. For most users} ®Save the scanned image as a sprite or as a bit-image 

the half-width scanner, capable of reading an image Draw file. 

up to 105mm wide, will be suitable. If you find your Conversion of dithered monochrome image to 

requirements grow, you can upgrade to Scavenger sixteen grey levels. Ideal for enhancing 

A4. The full A4 width device can scan a 216mm wide photographs. 

image. To obtain the greatest scanning precision, a Full control of optional sheet feeder to allow 

sheet feeder can be added to Scavenger A4. This is automatic scanning. 

fully automatic and can scan an entire A4 page under 

software control in just 15 seconds. Price Stock Code 
é Scavenger £194.95 

The Wimp-based software to operate the Beebug Scavenger 3000 £219.95 

Scavenger is incorporated in a ROM on the interface Scavenger A4 £439.95 

podule. Scavenger is operated from the Desktop, and Scavenger 3000. A4 £469.95 

you can choose whether you want the software to Sheetfeeder for Ad models £179.95 

install itself automatically on the icon bar, or whether All prices incliide VAT. Cavriage’on these items is £7, 

you wish to start it manually through a star WHA Avsiteles models of Scavenger are available now, 

command. Just some of the features offered by the the AS3000 models will be available in May/June, * 

software are: 


Technical Specification 

Maximum image width: 105mm for Handheld models; 216mm for A4 models. 

Maximum image depth: —_ Limited only by available memory 

Resolution: 100, 200, 300 and 400 dots per inch for handheld model; 200 dots per inch for A4 model 
Scanning mode: Reflective with CCD sensor 

Dropout Colour: Yellow-Green (570nm) 


Operational modes: Black and white or 16 grey levels for A4 model; 

Black and white or choice of three patterns of 32 grey levels (focusing, dot and mean) for the Handheld model 
Interface: Half-width expansion card, fitted internally to Archimedes, or in external case (supplied) to A3000 
Power Source: Internal for Archimedes; from external unit (supplied) for A3000 
Computer requirements: _ Either an A3000 or an Archimedes with RISC OS, a podule backplane and at least 1 Mbyte of RAM 
Software: ROM-based Desktop application 
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Fred Hartley and David Spencer explain the Quick Sort program from 
Jast month's Assembler Workshop, and show how to access Basic 
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T variables and arrays from ARM code. 


he previous issue of RISC User 
contained a Quick Sort program for 
sorting Basic arrays, together with 
instructions on how to use it. There were, 
however, no details of how the program 
works, and this is what is covered this 
month. The article is split into two fairly 
separate parts. The first deals with the 
Quick Sort algorithm itself, and explains 
how it. is implemented in the program. 
The second part shows how Basic 
variables can be passed to machine code 
programs, just as in the sort program. 


THE QUICK SORT ALGORITHM 

The basis of Quick Sort is the 
partitioning of an array into two sub- 
arrays, which while not necessarily in 
order internally, are ordered to the extent 
that all the elements in the first sub-array 
come before those in the second. The 
method for performing this 
partitioning is best illus- 
trated with a pseudo-code 
program, shown in figure 1. 
The term A(I) refers to the 
element in the array pointed 
to by the pointer I. The basic 
idea is that you move in two 
pointers from the left and 
right ends of the array comparing elements 
with a chosen reference element (the 
middle one in the array). When you reach 
the point where the element pointed to by 
the left-hand pointer is greater than the 
reference element, and that pointed to on 
the right is less than the 
reference, then the two 
elements are swapped. 
This is repeated until the 
pointers cross over. The 
pointers then split the 
array into the two sub- 
arrays. 


R 
R 
R 
Q) 
ie) 


Figure 2 shows the partitioning 
process for the letters off the top row of a 
keyboard. The first line shows the initial 
position, and subsequent lines the 
position immediately before a swap. The 
reference letter is shown in bold, and 


process 


j GRD wu wey 


ETOP QR TU WY 


Figure 3. The quick sort process 


Take the middle element as a reference 
Store its value in M 
Set pointer I to point to left-hand element 
Set pointer J to point to right-hand element 
Repeat 

While A(!) < M Increment I 


While A(J) > M Decrement J 
Ifl<=J 
Swap A(I) and A(J) 
Increment I 
Decrement J 
Until bd 


Figure 1. The partitioning routine 


subscripts are used to indicate the pointer 
positions. By the fifth line, the pointers 
have crossed over so no swapping takes 
place and the process is complete. The 
letters are now partitioned into two - 
those from the start up to I, and those 
from U to the end. 


Now comes the clever 
bit. The whole partition- 
ing process is repeated for 
the two parts of the array. 
This is performed recur- 
sively, so that it will be 
performed on the four 
parts resulting from this, and then on 
eight parts and so on. As the operation 
recurses, the parts obviously get smaller 
and smaller, until they are empty. At this 
point the recursion stops. When there are 
no further parts, the entire array will 
have been sorted into 
order. 


To illustrate this, 
figure 3 shows the 
stages of sorting the 
letters QWERTYUI 
O P again. Each line 
shows one level of 
recursion, with brackets being used to 
indicate the parts being partioned at that 
point. The letters in bold are those used as 
the reference letter. If the process is still 
not clear in your mind then you might like 
to try it with your own data. 
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IMPLEMENTING QUICK SORT 

Now that we are armed with the Quick 
Sort algorithm, we can look at how it is 
implemented by last month's program. 
The line numbers given apply to the 
listing in the magazine, not the disc 
version of the program. 


Lines 320-460 locate the address and 
size of the array, a process which we will 
look at in detail later. The type of the 
array is also determined at this point. The 
four lines from 480 to 510 form the body of 
the sort. They call the recursive part of 
the code to sort the entire array, and then 
return to Basic. 


The routine main that starts on line 
530 sets the pointers to either end of the 
section of the array being sorted, and 
calculates the address of the reference 
element. It then jumps to one of the 
routines ssorta (610-770), isorta (800-950) 
or rsorta (970-1130) depending on whether 
the array is string, integer or real. These 
routines perform the partitioning process 
and then jump to the code main3 (1150). 
This part of the code calls itself recursively 
to partition the two sub-arrays (provided 
they are not empty) and then exits. 


Other routines used in the program 
are compareR (1370-1560) and compareS 
(1730-1860) which are used to compare 
real and string values, swop (1880-2030) 
to swap five byte floating point numbers 
or string information blocks, and fetchx 
(1580-1710) to load five byte values into 
processor registers. 


PASSING VARIABLES TO MACHINE 
CODE PROGRAMS 

We turn our attention now away from 
the sorting part of the program, and look 
instead at how it accesses the Basic array 
being sorted. The key to this is the CALL 
statement, which is used to run a machine 
code routine. This is normally used in its 
simple form of: 

CALL addr 
where addr is the address of the routine to 
call. However, CALL also allows one or 
more variables to be passed to the routine. 
These are listed after the address, thus: 

CALL addr, variable, variable, ... 
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The variables can be simple ones (A%, B$, 
FRED etc.), array elements (for example, 
AB%(10)), variables involving indirection 
operators (!A, A?1, IR, $S etc.), or, as is 
the case here, whole arrays which are 
represented by their name followed by 
empty brackets, for example A%(). 


When a machine code routine is called 
using CALL, the ARM registers R9 and 
R10 are used to hold information about 
any variables listed in the CALL 
statement. Register R10 contains the 
number of variables passed, and will be 
zero if the simplest form of CALL with 
just an address is used. R9 points to a list 
describing each variable in turn. There is 
one entry in this list for each variable 
passed, and each entry consists of two 
32-bit words. The entire list is word- 
aligned, and so the entries can be read 
using the LDR instruction. 


For each entry in the parameter list, 
the first word is a pointer to the variable 
itself (in other words an address). This is 
called the /-value of the variable, which is 
short for 'left-value’. This term derives from 
the fact that such variables can appear on 
the left-hand side of an expression. What is 
actually pointed to by the l-value depends 
on the type of the variable, and we shall 
come back to that shortly. The second word 
of the entry indicates the type of the 
variable pointed to by the first word. The 
possible values are given in table 1. One 
important point to note here is that the list 
pointed to by R9 is in reverse order - hence, 
the first entry applies to the last variable 
in the list. 


Basic Variable Type 

8-bit integer 

32-bit integer 

40-bit floating point number 
String variable 


Indirection type string ($A) 
Integer array 

Floating point array 

String array 


Table 1. Variable types used by CALL 

We will now look at each possible 
variable type in turn, and explain for each 
exactly what the ]-value points to: 
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8-bit integer 
This is an 8-bit (byte) value accessed 
using the ? indirection operator. The l-value 
is the address of the byte. For example, 
CALL code, ?&12345 
would give a single parameter of type 0 
and l-value &12345. The value can be 
accessed using the LDRB and STRB 
instructions. 


32-bit integer 

This is either an integer variable, an 
element of an integer array, or an integer 
accessed via the ! indirection operator. In all 
of these cases, the l-value is again the 
address of the 32-bit integer. One important 
point to note though is that this address is 
not necessarily word-aligned, and hence the 
value cannot in general be accessed directly 
using LDR and STR. Instead, a short 
routine must be written to load and store a 
word to a non word-aligned address. 


40-bit floating point number 

The 1-value points to a floating point 
number stored in a 40-bit (5-byte) 
compressed format. This format will be 
examined in a future Assembler Workshop. 


String variable 

In this case, the value 
points to a five byte string 
information block (SIB). 
The first four bytes of this 
are the address of the first 
character of the string, and 
the fifth byte indicates the 
length of the string. Again, 
the four byte address is not 
guaranteed to be word- 
aligned, and hence cannot 
be read directly using the 
LDR instruction. 


‘eee he! 


Indirection String 

For an indirection type string (in other 
words, those accessed using the $ 
indirection operator) the l-value points 
directly to the text of the string. The end 
of the string is marked by a carriage 
return character (ASCII 13). 


Array types 

Whenever a whole array is specified, 
the l-value points to a single word-aligned 
word which in turn points to an array 


header followed by the actual entries that 
make up the array. The header starts with 
a list of the sizes of each subscript (as 32- 
bit words), followed by a word containing 
zero to mark the end. For example, if an 
array was declared using: 
DIM A(10,3,7) 

then the subscript list would be 11, 4, 8, 
0. The numbers are one greater than 
those given in the DIM statement as the 
subscript range starts at zero and not 
one. The subscript list is followed by a 
word containing the total number of 
entries in the array - in other words the 
product of the entries in the subscript 
list. This would be 352 for the above 
array. The header is followed by the 
elements themselves, as either 32-bit 
integers, 40-bit floating point values, or 
40-bit SIBs, depending on the array 
type. For multi-dimensional arrays, the 
ordering is such that the last dimension 
varies fastest. For example, in the array 
A(1,1), the elements are in the order 
(0,0), (0,1), (1,0) and (1,1). Figure 4 
shows the pointers and array header 
pictorially. 


[Array pointer} > [2 _| Size of 1st subscript 
i, See] Size of 2nd subscript 
| 0 _| Endoof subscript list 


i eee 2] Total number of elements 


Figure 4. Arrangement of array A% (1,1) 


One point to note from the above 
discussion is that because a pointer to the 
variable value is passed to the routine, 
rather than the value itself, the routine 
can alter the value. This is analogous to 
parameters to Basic functions and 
procedures being prefixed with the 
keyword RETURN, although the actual 
mechanisms involved are quite different. 
This method is normally called call by 
reference, though in the BBC Basic Guide 
it is referred to as value-result passing. 
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AN EXAMPLE PROGRAM 

The listing below contains a short 
program which when called using CALL 
displays the l-value and type of each of its 
parameters. Having assembled the code 
you can define a number of different 
variables and try it out using: 

CALL code,.... 
with your choice of parameters. 


The data making up any of the 
parameters can be examined using the 
built-in *MEMORY <addr> command, 
where addr is the l-value of the parameter 
in question. *MEMORY displays its 
output word by word. To get a byte- 
oriented display use the alternative form: 

*MEMORY B <addr> 


In the quick sort program, lines 330 to 
460 locate the array and its type. First of all, 
a check is made that the parameter is indeed 
an array. The l-value is then read from the 
parameter list, and the list of subscripts 
skipped over. Finally, the size is read, and 
the address of the first element calculated. 


RETURNING RESULTS 

So much for passing parameters to a 
machine code routine, but what about 
getting results back. One obvious way is 
to use the call by reference property to 
alter one of the original parameters. A 
point to bear in mind is that the length of 
a string musn't be changed as this will 
either require extra memory, or free some 
memory. In either case, Basic will get 
confused and probably crash. Similarly, 
the size of arrays cannot be altered. 


A second method is to use a parameter to 
pass the address of a block of memory 
reserved with the DIM statement. The 
routine can then put any results in this 
block, and the Basic program can read them 
using the indirection operators (?, !, $ and |). 


In next month's Assembler Workshop 
we will look at implementing Desktop 
applications as relocatable modules. 


Note: Mr Hartley acknowledges his 
indebitness to Peter Cockerell's book 
ARM Assembly Language Programming. 


10 REM >ParamPeek 
20 REM Program List CALL Parameters 
30 REM Version Al1.0 
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40 REM Author David Spencer 
50 REM RISC User June 1990 
60 REM Program Subject to Copyright 


80 DIM code 500 

90 FOR pass=0 TO 3 STEP 3 

100 P%=code 

110 [OPT pass 

120 TEQ R10,#0:BNE code2 

130 SWI "OS Writes" 

140 EQUS "No parameters given" 

150 EQUW &DOA:EQUB 0 

160 MOVS PC,R14 

170 .code2 ADD R9,R9,R10,ASL #3 

180 .code3 LDR R5, [R9, #-4]! 

190 LDR R4, [R9, #-4] !:ADR RO, typetab 

200 .code4 LDR R1, [RO], #4 

210 TEQ R5,R1:TEQNE R1, #&FF:BEQ code5 

220 .code45 LDRB R1, [RO], #1 

230 TEQ R1, #0:BNE code45 

240 ADD RO,RO, #3:BIC RO,RO,#3:B code4 

250 .codeS SWI "OS Write0" 

260 SWI "OS _WriteS" 

270 EQUB 10:EQUB 13 

280 EQUS "L-Value = &":EQUB 0 

290 MOV RO,R4:ADR R1,buffer:MOV R2, #10 

300 SWI "OS_ConvertHex8" 

310 .code6 LDRB R1, [RO], #1 

320 TEQ R1,#ASC"0":BEQ code6 

330 SUBS RO,RO, #1 

340 SWI "OS Writed" 

350 SWI "OS NewLine":SWI "OS NewLine" 

360 SUBS R10,R10, #1 

370 BNE code3 

380 MOVS PC,R14 

390 : 

400 .buffer EQUS " # 

410 ALIGN 

420 .typetab 

430 EQUD 0:EQUS "8-bit integer":EQUB 0 
: ALIGN 

440 EQUD 4:EQUS "32-bit integer":EQUB 
O:ALIGN 

450 EQUD 5:EQUS "Floating point":EQUB 
O:ALIGN 

460 EQUD &80:EQUS "String variable":EQ 
UB 0:ALIGN 

470 EQUD &81:EQUS "Indirection string" 
:EQUB 0:ALIGN 

480 EQUD &104:EQUS "Integer array":EQU 
B O:ALIGN 

490 EQUD &105:EQUS "Real array":EQUB 0 
: ALIGN 

500 EQUD &180:EQUS "String array":EQUB 
O:ALIGN 

510 EQUD &FF:EQUS "*** Unknown type ** 
*"3EQUB 0:ALIGN 

520 ]NEXT AU 
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PRODUCT NEWS FOR 
/-| USERS! 


SCSI CARD AND DRIVE 


Everything you need to upgrade your 
A3000 or Archimedes. 
Interface card £44 Q.00+VAT — Hard Drive Kits £375, 00+VAT 


from from 


PRESENTER II 
A series based presentation software 


RISC OS based . that allows you to make slides and 


graphics package (graphics, 0.h.p.’s obsolete. £ +VAT 
charts etc...) for education 199% 


and business. 


£20,95+VAT & / 
399 COMING Soon peek 
COLOUR CONVERTER [a —— 


Software and hardware card for capturing 
full colour images using the monochrome \ (oe) Ke) 0) 5} DIGITISER 


Watford Digitiser and colour video equipment 


tingle card real-time full colour 


£ *VAT BY foci 3 : 
EN <p> 169% Jigitiser for Archimedes 
(imam Education discounts and site licences for software are available 
VISA 
es 


le NG EN Ue TO ea eeorne 
Le ee es 098 685 477 ff 


Please send me more information about: SCSIO Presenter [1 Colour Converter O 


Wood Farm, Linstead Magna, Halesworth, Suffolk IP19 ODL 


Presenter Story 0 Colour Digitiser 0 


Name Address 


Tel No. 
LINGENUITY, Wood Farm, Linstead Magna, Halesworth, Suffolk [P19 O0DU 
LINDIS INTERNATIONAL 
Tel: 098 685 477 RU ao 


Clares’ Knowledge Organiser 


Reviewed by Mark Sealey 


T he latest offering from Clares has 
much in common with Hyperbook 
(reviewed in Volume 3 Issue 3), and even 
more with a now defunct package called 
ArcTFS. Clares has now taken over the 
development and marketing of ArcTFS 
(Archimedes Text Filing System) and re- 
released it in a rewritten and much 
enhanced format. 


Hina shane its France pre *89 (GL) 
ie oulture 


feet oF P0389 


ic, (GLOSS) 


led in Li . the crown (GLOSS) 


pe ici 


i 
ee Ee at 


ir ratic enti the 104 


oer re co 


A Knowledge Organiser screen 


A Text Filing System means the 
management, retrieval, searching and 
sorting of text in such a way that ideas, 
sentences, dates and sources (such as 
bibliographical references) are linked and 
organised conceptually. It explains well the 
function of the software reviewed here. 


BASIC IDEA AND USES 

The present product is billed as an aid 
to research, writing and note-taking 
(material can be imported from the Z88, for 
instance). More sophisticated uses consist 
of drafting and re-scheduling scattered and 
unsequenced information for eventual 
export into Knowledge Organiser’s own 
text editor, or into word processors like 
Pipedream and 1st Word Plus. 


Knowledge Organiser handles text as 
such, but is also able to tag text items for 
further processing as if the component 
words of any entry were discrete data 
items in a database. Because of this it 
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ought to be an ideal tool for such tasks as 
cross-referencing, quick keyword 
searching, sorting and maintaining 
journal abstracts, updating and processing 
research and library data etc. 


The example file which comes on the 
(unprotected) disc deals with the French 
Revolution; all sorts of quotes, facts and 
details of events as well as economic and 
social data are linked to one or more 
explanatory “contexts” or hooks. Any item 
of text (say a quote from a biography of 
Napoleon) might be recalled, searched for 
or sorted in terms of one (or more) 
contexts such as: “revolutionary”, “war”, 
“aristocracy” etc. 


Two things, however, will quickly 
strike even a relatively inexperienced 
Archimedes user: the utterly non- 
standard user interface, and the manual’s 
rather unhelpful explanations and 
inadequate tutorial guidance for someone 
unused to the software. 


STRUCTURE 

At the lowest level, material to be 
organised has four facets associated with it 
(each with its own separate file): the text 
itself, the source (maybe a page number in 
a published book or journal), a date, and, 
hardest to grasp, a context. The latter is 
really the rough equivalent of a Keyword in 
a journal index. In the case of the review 
you are reading the contexts might well be: 

"CLARES/KO/ARCTFS/REVIEW/RU" 


USER INTERFACE 

In Knowledge Organiser we have a 
major “content-free” product clearly 
designed for a wide market, but one which 
is not multi-tasking. True, it will return 


* the user to the Desktop and originates 


from an icon on the icon bar, but that is all. 


One result of this is that windows with 
data and instructions are the size Clares, 
not you the user, want them to be. 
Another is that familiarity with the Wimp 
environment cannot be transferred to 
Knowledge Organiser. 
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One of the obvious reasons for this 
conscious choice by Clares is the very 
complexity of paths through the program. 
Most menus and sub-menus are 
highlighted in Clares own graphic style. 
There are also some very vague clicking 
requirements: “just next to the word Date”, 
to quote from one spot in the manual. 


IN USE 

This aside, what actually happens 
when using Knowledge Organiser? From 
an initial screen, concerned essentially 
with files and directories, either old 
material is selected or a new file created. 
The display then changes to one split into 
four horizontal panels. The largest of 
these (about half the screen) is for the text 
entries themselves. 


Towards the bottom are the legends 
associated with Context, Source and Date. 
In between these two is a prompt line, 
giving wholly context-sensitive instructions 
and feedback, while at the very foot of the 
screen are the primary menus controlling 
most searching, filing and other linking 
options. Most of these lead to sub-menus. 


CREATING A FILE OF YOUR OWN 

It is likely that sooner or later you will 
want to write a database of your own. 
Imagine one detailing the conclusions 
reached in RISC User reviews over the 
past three years. Knowledge Organiser 
would take you logically through the 
processes of setting field lengths and 
determining contexts etc. These might be 
“hardware, utilities, graphics, languages, 
communications and books”. Each 
category could be added to and amended 
later, but must conform to one or two 
rules: a maximum overall length of 40 
characters, within which no one element 
may exceed 6 characters. A limit of one 
line for all entries except Text and Sources 
is, however, no real disadvantage. 


Once set up, this structure can be filled 
with data from a variety of sources 
including text typed in directly from the 
keyboard or imported from a word 
processor, and subsequently edited if 
required. More significantly, text from 
many sources, notably on-line databases, 


can be formatted to run in Knowledge 
Organiser. If Clares can expand the 
supplied !DeKOde utility to support 
Hyperbook and other similar material (it 
already handles top bit set ASCII data), 
without infringing copyright, then this 
will enhance the application of the 
software further. 


However, there are times when the 
software feels less than robust. In one or 
two cases there is actually NO exit other 
than creating, then deleting, a dummy file 
if you embark on certain processes by 
mistake. Unlike the standard Wimp, it is 
not always enough just to click anywhere 
outside the current window to abort. Nor 
does the Escape key itself achieve this. 


CONCLUSIONS 

Here is a splendid idea. Normal fixed 
field-length databases could never achieve 
what Knowledge Organiser does. The 
ability to enter masses of material in free 
format, and to impose both a textual and 
conceptual structure on it exactly as you 
want could be of immense value to anyone 
who constructs or composes anything but 
the most basic of text files. 


At the moment it is the best tool of its 
kind we have for the Archimedes, though 
Genesis, Hyperbook and similar packages 
deserve just as close attention as Knowledge 
Organiser. It represents a real advance on 
the original ArcTFS, and it is attractively 
presented and reasonably priced. 


Yet real reservations must remain 
about the use of a non-standard interface, 
and the poor tutorial and fragmented 
nature of the documentation in general. 
This is one of those rare occasions when 
you really would be well advised to make 
every effort to see Knowledge Organiser 
demonstrated before buying since, 
however attractive the idea may be, it is 
not without its flaws. 


Product 
Supplier 


Knowledge Organiser 

Clares Micro Supplles 

98 Middlewich Road, 

Rudheath, Northwich, 

Cheshire CW9 7DA. 

Tel. (0606) 48511 

£59.95 inc. VAT. RU 
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Desktop Hotkeys II: 


by Felix Andrew 


This program is available only on the 
magazine disc. 


The application described here (called 
Windower) allows window functions to be 
controlled directly from the keyboard 
(rather than the mouse) using so-called 
hotkey sequences (see RISC User Volume 
3 Issue 1). Once installed it allows 
windows to be brought to the top, sent to 
the back, resized and closed at the press of 
a single key. It also provides nine window 
positions allowing windows to be moved 
and resized to occupy these positions. This 
is useful for positioning directory viewers 
so that they do not overlap each other, 


Action 

Brings the window to the top 

of the other windows. 

Sends the window to the back of 
the other windows. 

Closes the window. 

Makes the window full size. 
Makes the window small size. 
Positions the window in one 

of nine specific locations on the 
screen which form a 3 by 3 grid. 
Double click. 

Multiple click. 

Move mouse. 

Fast mouse move 


Table.1 List of keystrokes 


USING THE APPLICATION 

The hotkey functions are activated by 
double clicking on the Windower icon to 
install it on the icon bar. The keys then 
recognised by Windower are listed in table 
1, Each key function affects the window 
under the pointer. However, if the caret is 
present in the currently active window, all 
keystrokes are passed directly to this 
application. For Windower to function 
correctly the caret must be removed and 
this is achieved by holding down the Alt 
key, whereupon the keys as listed in table 
1 will have the same effect as before. 
Releasing the Alt key replaces the caret in 
the window. Care should be taken not to 
close the window that was in control of the 
caret, as this can cause confusion. 


Key Stroke 


Keys 1-9 


Space 
Return 
Cursor 
Ctr-Cursor 
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Keyboard window control 


If the caret has been removed using 
the Alt key, and the window is scrolled or 
re-sized, then when the caret is returned 
to the window it may seem to be in the 
wrong place. However, as soon as you type 
a key, the caret will be re-positioned at the 
correct place. 


If the pointer is not over any window 
then the operation is performed on the 
last manipulated window. This allows 
windows to be bounced around the screen, 
by using the numeric keypad until the 
best position is found. 


MOUSE CLICKS 

The Space and Return keys provide 
debounced and repeated right-hand mouse 
button clicks (Adjust). This comes in 
useful for opening and closing directory 
viewers. Unfortunately, not all mouse 
clicks can be emulated in this way. It is 
not possible to click on the frame of a 
menu using the Space or Return keys, nor 
is it possible to drag a window using the 
cursor keys. 


MOUSE MOVEMENT 

Using Windower, the pointer moves 4 
pixels at a time, unless Ctrl is held down, 
when it moves 16 pixels at a time. The 
cursor keys are buffered, so you may find 
that the mouse continues moving after the 
keys have been released. 


ENHANCEMENTS 

Clearly, the program can be modified 
to perform other more complicated tasks 
such as window scrolls, dragging icons, 
etc., in fact almost anything that you can 
do using the Desktop! 


NOTE: You will need to ‘unplug’ the 
International Keyboard module before the 
hotkeys will function correctly with the 
Alt key depressed. To do this, press F12 
and type: 
Unplug International. 

Then press Return a second time to get 
back to the Desktop. RU 
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By Mike Williams 


W. will conclude our discussion of the 
Task Manager started last month by 
looking at one of its most important 
functions, the allocation of memory. 


The last section of the Task Manager 
display, entitled System memory allocation 
often proves of greatest interest, allowing 
you to both monitor and control memory 
allocation for various functions. For screen 
memory, the Desktop will forcibly acquire 
whatever memory allocation it needs for 
your choice of mode setting, but for your 
own programs, and for some commercial 
programs, you may need to make sure 
sufficient memory is allocated before the 
program or application will run. You will 
also find that when you return to the 
Desktop, the memory allocation again 
reverts to what the Desktop requires, 
which can sometimes be a nuisance. 


If modules are loaded by double 
clicking on their icons, or at the command 
line prompt, they will also grab whatever 
memory they need, irrespective of the 
Module area setting. However, if you load 
modules from within the Basic 
environment you may encounter problems 
if sufficient memory for this purpose has 
not been allocated beforehand. 


The Font cache is particularly 
important if you are using outline or anti- 
alias fonts (in DTP or elsewhere), and 
increasing the memory allocated here to, 
say, 64K can significantly speed up 
processing and the regeneration of screen 
displays. If you have the memory 


available, then double or quadruple that _ 


allocation when fonts are being used. 
Tuning your system like this can pay 
considerable dividends, but you will 
always need to experiment to determine 
the optimum arrangements. Allocating 
more memory for font cacheing in a DTP 
package can speed up processing, but may 
also reduce the maximum size of document 


which you can then handle, and may not 
leave sufficient memory for a printer driver 
or other application. In these 
circumstances, do all your DTP work with 
adequate font cache and no printer driver 
installed. On completion, reduce the 
document window to minimum size, so that 
no text appears visible, reduce Font cache 
(to zero if necessary), load the appropriate 
printer driver, and then print. 


Under RISC OS, System Sprite space 
is seldom used, so-called user sprites being 
preferred (see RISC User Volume 2 Issue 
3). The Wimp also maintains a table of 
Wimp sprites (used to hold the icons 
employed in directory viewers for 
example). User sprites take memory from 
within the program’s own memory 
allocation and thus require no pre- 
assignment of memory for this purpose, 
unlike system sprites. However, if a 
program fails to run, or runs with a partly 
corrupted display, check if allocating more 
screen memory or more sprite memory 
will resolve the problem. Of course, if 
memory space is at a premium, then do 
make sure all allocations are reduced to a 
minimum, 


The last controllable item for memory 
allocation is the RAM disc. This allocates 
part of memory as a mass storage system 
which can then be treated as a pseudo 
disc. This has been covered previously in 
RISC User (see The RISC OS RAM Filing 
System in RISC User Volume 2 Issue 5), 
and is most useful for copying from disc to 
disc on single drive systems. 


In general the Task Manager provides 
a means of monitoring memory allocation 
and fine tuning the system to achieve 
optimum performance which renders it 
invaluable. However, if you really are 
short of memory for the tasks you want to 
run, a memory upgrade may in the long 
term be the only satisfactory solution. ay 
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Into the Arc 
Avoiding Errors with Typed Listings 


by Alan Wrigley 


Ak yping in listings from the magazine 
can be very rewarding, but may also be 
very frustrating. It is easy, particularly 
with a long listing, to make a small typing 
error which subsequently eludes the most 
careful scrutiny. 


Armed with a little knowledge and a 
degree of patience, however, it is often 
possible to track down the source of the 
error with a success rate of which 
Sherlock Holmes would have been proud. 
This article will explore some common 
typing errors and give some pointers to 
successful debugging. 


THE BASICS 

Newcomers to computing, presented 
with the Desktop as their first view of the 
micro world rather than the Basic prompt 
as in earlier Acorn machines, are often 
confused as to exactly what is, and what is 
not, a Basic program when listings are 
published in RISC User. You can identify a 
Basic program by the fact that each 
program line starts with a line number, 
usually (but not necessarily) in increments 
of ten. Some of our features include other, 
usually short, listings, without line 
numbers. These contain, not Basic 
instructions, but special commands 
directed at the RISC OS operating system. 
Wimp applications, for example, normally 
have at least one such listing, and the 
accompanying text will give instructions on 
how this is to be produced. The one you will 
meet most often is an Obey file called !Run. 
Obey files can be created using Acorn’s Edit 
- see your User Guide for instructions. 


WIMP PROBLEMS 

All Basic programs can be created, 
listed, edited and run within the Basic 
environment (from the Desktop, press 
Ctrl-Shift-F12 then type BASIC). 
Unfortunately, programs which use the 
Wimp are more difficult to debug than 
others. A Basic program running in a 
single-tasking environment (i.e, non- 
Wimp) will, if it fails, normally generate a 
standard Basic error, and a message, 
usually meaningful, is displayed on the 
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screen together with the line number; an 
example would be “Unknown or missing 
variable at line 2150”. 


However, if the program is multi- 
tasking, and thus under the control of the 
Window Manager, any failure will return 
you straight to the Desktop, and the error 
message will be displayed by the Wimp. 
Assuming that the program does not have 
any special error handling procedure, this 
message will be exactly the same as that 
normally produced by Basic, but will not 
show a line number. If you subsequently 
press F12 and then enter Basic, the 
language will be re-initialised and the 
error status, together with all the program 
variables, will have been lost. 


I will offer some tips for dealing with 
this problem later in the article, but first I 
will describe some of the most common 
errors with typed listings, and how to cure 
them. The following assumes that you are 
running the program from within Basic. 


TYPNIG MISTOKES 

Unknown or missing variable will 
always be caused by mistyping (unless 
there is an error in the listing!). First list 
the line in which the error occurred, 
identify all the variables in that line, and 
try to print their values. For example, if 
the line reads: 

100 PRINT i%,varl,var2 
then the variables in that line are i%, varl and 
var2. Printing the value of each in turn (e.g. 
PRINT varl) at the command prompt will 
show which one is unrecognised, You should 
then look for all occurrences of that variable in 
the program and check your typing very 
carefully. Did you perhaps type Varl instead of 
varl? Or maybe you missed out the line 
altogether where its value was declared? 
Remember also that in an assembler listing, 
labels are treated as variables. 


The most useful tool for this job is the 
Basic Editor which is supplied by Acorn as 
a module on Applications Disc 2. Full 
details on how to use this are in the BBC 
Basic Guide, but the most useful facility 
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for the purposes of this article is Search, 
which searches the program for a given 
string, and is activated by function key 
F7. If the search string is preceded by the 
character {, the search is case insensitive, 
so specifying, for example, “(var” would 
find both Var and var. The simplest way to 
use the Basic Editor is with the Bedit 
utility published in RISC User Volume 3 
Issue 4, but this can only be used from 
within the Desktop environment. 


Another reason for the unknown 
variable error might be mistyping the 
punctuation in the line. For example, in 
the line: 

150 FOR A=B TO CPRINT A:NEXT 
there should have been a colon between C 
and PRINT. As a result, the computer is 
looking for a variable called CPRINT, 
which it will not find. 


The error can also occur if you are 
reading DATA statements and try to read 
a string into a numeric variable. So if the 
error line contains a READ statement, 
check your DATA lines carefully - it is 
very easy to omit a comma, or include a 
spurious one, 


MORE MISTAKES 

No such function/procedure will mean 
that you have mistyped a procedure or 
function name, either where it is defined 
or where it is called. 


Syntax error or Mistake indicates that 
you have mistyped a Basic keyword, or 
again omitted some essential punctuation 
mark. It should be fairly simple to spot 
the offending statement by listing the line 
and checking each keyword carefully. 


SWI name not known is generated 
when the program makes an unknown 
operating system call. In Basic, this is 
done by the SYS statement. All SYS call 
names must be typed exactly as they 
appear in the listing, with upper and 
lower case where shown, and the name 
must be enclosed in quotes. Be careful too 
that if the name contains an underscore 
character, you do not type a hyphen 
instead. This error can also be generated 
if a call is made to a module which has 
been unplugged - some games do this to 


free more memory, even though such 
actions are frowned on by Acorn. 


CHARACTER CONFUSION 

It is not difficult when typing listings 
to confuse O (upper case 0) with 0 (zero), 
or 1 (lower case L) with 1 (one). Another 
character which sometimes causes 
confusion is the vertical bar |. This 
appears on the keyboard with a gap in the 
middle, and is produced by typing Shift 
with backslash. 


MULTI-TASKING PROGRAMS 
In order to de-bug a multi-tasking 
Basic program you have to resort to a 
little trickery. Include at the start of the 
program a line which reads: 
ON ERROR MODEO:REPORT:PRINT" at line "; 
ERL;END 
If the listing already contains a line 
beginning “ON ERROR’, remove this 
original line temporarily. 


If you now run the program from 
Basic, instead of from the Desktop, then it 
will appear to work correctly as a Wimp 
task, but any errors will drop you back 
into Basic and report the error and line 
number as before. You can now list the 
program and interrogate the variables as 
described earlier. Don’t forget to remove 
the error handler once the program is 
working correctly, or replace it with any 
error handler given in the listing. 


Note that an error handler of this type 
can be used in all Basic programs, not just 
those which operate under control of the 
Wimp. In fact, it is a good idea always to 
include an error handler in every program. 
The point made here is that, for multi- 
tasking programs which you are debugging 
from Basic, the error handler must be 
included as otherwise you may be faced 
with a blank screen if anything goes wrong 
and it will not be clear what to do next. 


The subject of de-bugging Wimp 
programs has also been covered from time 
to time in our Mastering the Wimp series. 
Also, the Desktop File Loader (Volume 3 
Issue 6) is a very powerful Wimp 
debugging tool. There is no need, then, to 
despair if you have a problem - simply 
apply a logical approach to the solution 
and it will soon be found. RU 
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Selecting the CSD from the Desktop 


by Martyn Lench and Adam Goodfellow 


V V hile the RISC OS Desktop is very 
useful for file manipulations, there are 
often times when it proves awkward to 
return to the previous Currently Selected 
Directory (CSD) after some other action. 
This often happens after you have pressed 
F12 to access the command line prompt, 
and it can be tedious to return to the 
correct directory if the file you are 
working on is some way down a directory 
tree, and you cannot remember the full 
pathname. Instead, you have to enter 
several *DIR and *CAT commands to find 
and select the correct directory as the 
CSD. It would be much better if the 
correct directory could be selected as the 
CSD before pressing F12, and avoid the 
use of star commands. 


One solution is to create a one line 
Obey file which should be stored in each 
directory that you wish to be able to select 


as the CSD. Such an Obey file is best 
created with Edit, and should contain: 
DIR <Obey$Dir> 

You could call your copy !!CSD (so it 
appears at the top of any catalogue). Keep a 
copy in the root directory of your work disc, 
and it can then be readily copied into any 
other directory where it is required (and it 
can also be used to select the root directory 
at any time as well). To use it, simply 
double click on the !!CSD icon in the 
directory window to be selected as the CSD. 


The Obey file works by sending a 
*DIR command to RISC OS to set the 
CSD to that stored in the system variable 
Obey$Dir. This system variable stores 
the parent directory (pathname) of any 
Obey file when it is run, which is just 
what is needed (incidentally, any 
alternative solutions to this problem will 
be welcome). RU 


“FIRST 


ADVANCED STATISTICAL SYSTEM 


For Acorn Archimedes; BBC Models B, B+ and Master; "Industry Standard" machines 
A powerful and practical tool for Research, Industry, Business, and Teaching 


Integrated, interactive, robust, fast, accurate, modular. Designed to facilitate data critique. 

Many data entry options. Full data management and formatted display. Extensive data transforms. 
Handles missing values and data subsets. Scatterplots, regression plots, function plots. 
Univariate statistics. Paired and unpaired t tests. Chisquare tests. Nonparametric methods. 
Unrivalled REGRESSION facilities eg weighted, through the origin, standardised. Full statistical information. 
Residuals, fitted and predicted values. Much more. Correlations. ANOVA. Contour plots of regressions. 
Regression DIAGNOSTICS - VIFs, influential points etc. Automatic warnings. 

ROBUST regression - many influence functions. Powerful NONLINEAR least squares 
Time Series, eg moving averages, exponential smoothing, causal models. 

One- Two- and Three-way ANOVA subsystems. Distributions generator. Histograms. Linear Calibration. 
Cluster analysis. Many other powerful analytical and descriptive features. Full utilities. 


Price £120-£180 (machine and version dependent). Special RISC USER discount available. 
There's far foo much to describe here. Get full information now from: 
Serious Statistical Software, Lynwood, Benty Heath Lane, Willaston, South Wirral L64 1SD Tel. 051 327 4268 
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COST EFFECTIVE CAD 


NEED 


Created speciticaly for the Archimedes, DESIGNER INTRO is based 
In its big brother | (ARCHIMEDES). |t shares the same 

uniquely logical menustructure and many ofthe powertu draughting 
routines. Enough power in fact to cope with all of most peoples’ 
draughting requirements. Many of 
There isone feature however ‘cannot show -its most important 
‘one - the simplicity of use that guarantees a short learning curve and 
speedy drawing generation. 


FEATURES 

Fully menu driven with simple No practical limit to the number of 
prompts and instructions for all drawing elements that may be 
routines, creat 


User definable grid with grid lock. — Comprehensive transformation 
1d lock onto ne: commands, MOVE, ROTATE, 


rest end of 3 
oreontreofsarciercie,. MIRROR IMAGE, ALTER SIZE. 


with a single button press. No practical limitto the size of, 
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important for engi Created. Library items can then be 
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plications. Nine in-bulf ac types Incorporated into the current 
alone. drawing at any size, angle, position. 
Ellipses, full or part. 


Zoom, scale and pan facilities (plot- 
‘outs may be taken at any time), 

Output to wide Hyf 2 of line: Picton 
‘software aut from A5t0.A0, e.g. Graphtec, Hewlett 
tersections.) Packard, Hitachi, Plotmate, Roland, 


etc. Plus screen dumps for 
le MODIFY command allows. FX/MMIRX compatible printers. 


forwards or backwards. The drawing COST EFFECTIVE 

Inay be entered at ary point thus ° §8GnancuiMeDeS OP 
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alter drawings. kept the features that made 


Automatic o¢ manual dimensioning, DESIGNER (BBC 5 0 popular. There 
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Textentry atanysize, angle orsiope. With it), itis 4 trae working syste 
(Text output aes ‘only by the ata velit price. sige 


plotter a 
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Hatching at any angl i 
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Powerful ELEMENT (layer) PERIPHERALS 

SLORES: Please remember that TechSoft can 
supply a wide range of CAD related 
peripherals and accessories, 29. 
plotters, plotter pens, etc. 


Cheque. swith order pi payabl 
‘order please, le 
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Wild Vision’s Hawk V9 Colour Digitiser 


Reviewed by Mike Williams 


of Hawk V9 colour digitiser was first 
previewed back at the PC Show last 
September, but has only recently become 
available in a full production form. The 
result is a polished package which 
performs well in its price bracket. 


The Hawk V9 consists of a full width 
expansion card for the A300 or A400/1 series 
(not A3000), supporting software on disc, and 
an accompanying manual of 24 A4-sized 
pages. The circuit board looks to be a very 
competent piece of work, which like all 
Archimedes podules 
requires the prior 
installation of a 
backplane into 
your machine if 
one is not already 
fitted. The Hawk 
V9 board is then a 
simple fit. Once installed, it presents a 
single BNC connector for video input. 


Small 


Refresh time 0.1 
Grab time 1.5 


Software support is in two forms: an 
on-board ROM containing a resident 
driver module, and on disc, an application 
for grabbing and manipulating digitised 
images. The module provides a number of 
SWI calls, all of which are documented in 
the manual. 


The majority of users will no doubt be 
satisfied with the FastGrab application. 
Assuming an input video signal is present, 
double clicking will install FastGrab on 
the icon bar and open a small RISC OS 
window containing a live display of the 
video input updated in real time. To the 
left of the window there is a set of four 
icons representing the tools you are most 
likely to need. 


THE LIVE TOOLBOX DISPLAY 

First of all, the PAL decoder provides 
slide bar controls for brightness, contrast, 
and saturation. The levels are also shown 
as three values, which helps in achieving 
the levels recommended by the manual. In 
practice I felt that this provided more 
convenient and accessible control of these 
characteristics than the rear-mounted 
rotary knobs of the Pineapple digitiser 
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Window Size to 


Table 1. Typical performance figures for the 
Hawk V9 digitiser (times In seconds) 


reviewed in RISC User Volume 3 Issue 3, 
though possibly less sensitive. 


A second icon at the side of the live 
display allows a choice of 12-bit or 8-bit 
data. The V9 board is designed to grab 12 
bits of data per pixel (4 bits red, 4 bits green 
and 4 bits blue). However, RISC OS can 
only handle at best 8 bits of data per pixel. 
To convert the digitised 12-bit image to 8-bit 
Archimedes format, FastGrab uses a 
version of ChangeFSI (a powerful 
conversion routine originating from Acorn). 
This uses dithering 
increase the 
apparent range of 
colours, and is 
essential to achieve 
a good quality 
result. However, 
you can also grab 
an 8-bit image to start with, though this 
will normally be inferior to that converted 
from a 12-bit one, as there is then no 
software enhancement. 


The V9 will continually update the live 
window display, the data being stored in the 
V9’s own memory. To grab an image you 
select the camera icon from the live toolbox, 
which saves the current image to the Arc’s 
memory. A copy of this image will be 
displayed in a further window on screen. If 
there is insufficient memory available, 
FastGrab will automatically use disc space 
instead. A Force cache option sets this as 
the norm, keeping user memory free for 
other purposes. 


Medium Large 
0.25 0.5 
1.75 2.0 


The live display window can be in one of 
three sizes (and you can select the window 
size for the grabbed image as well). 
Typical performance figures, depending 
upon window size, for live image refresh 
and image grabbing are shown in table 1. 
In mono (using mode 12 or similar) the 
refresh rate is approximately 50% slower, 
as the board is optimised for mode 15. 


THE FASTGRAB MENU 
Pressing the Menu button with the 

pointer over the live display will reveal a 

menu which includes the live toolbox 
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functions and others. From this you can 
control the window size for the live 
display, and for any grabbed screens. You 
can also select the mode for grabbed 
images, but this must be a mode which 
supports 256 colours (normally mode 15). 


Grabbed images can be saved in one of 
two formats: as raw 12-bit data, or as 8-bit 
sprites created with ChangeFSI. Any 12- 
bit image files can be reloaded by 
dragging the file icon to the FastGrab icon 
on the icon bar. 


ChangeFSI also has its own menu, 
allowing the various control parameters to 
be set as you wish. You can control output 
mode, scaling, palette, and image 
enhancement, The latter includes the 
setting the level of sharpness or softness 
in the processed image. 


The Hawk V9 Colour Digitiser board 


THE BOARD IN USE 

In practice the use of a standard Wimp 
environment makes control of the digitiser 
and its functions simplicity itself. 
Although FastGrab is multi-tasking, real- 
time colour digitising is heavy on 
processing power, so don’t expect to have 
other tasks in operation and maintain the 
speed at which images are digitised. 


The live display is intended only as an 
indicator of the current picture, the best 
result always being obtained by grabbing 
an image and processing it with 


ChangeFSI. We obtained excellent results 
from video tape sources, but less 
satisfactory results with a direct camera 
image (using the same equipment as in 
the previous review). There were a 
number of bugs in the software, but Wild 
Vision assure us that these are being dealt 
with. 


DOCUMENTATION 

The documentation is well produced 
but I would describe it as adequate rather 
than good. It is certainly not clear on the 
meanings of all the functions of the live 
toolbox, and there is confusion between 
this and the full menu display, and the 
grabbed image menu and its toolbox 
display. Other parts of the manual are 
vague in terminology. However, all the 
information you need is there, and a short 
period experimenting with the functions of 
the board and software will soon teach you 
all you need to know. 


The manual also covers installation of 
both hardware and software, details of the 
SWI calls supported by the Hawk V9 
module, and other technical information. 


CONCLUSIONS 

This is an excellent product which does 
its job well and at a reasonable price. 
Although the system will work on al 
Mbyte machine, it will work better (ie. 
faster) if 2 Mbytes are available, and a 
hard disc will clearly speed up the storage 
of digitised images. 


One might have expected more functions 
for manipulating grabbed images, and the 
manual has its limitations. Nevertheless, 
the Wimp interface makes control of the 
whole system very easy, and the whole 
set-up is highly appealing. 


Some sample digitised images are 
included on this month’s magazine disc. 


Product Hawk V9 Colour Digitiser 
Supplier —_ Wild Vision 
6 Jesmond Road, 
Newcastle upon Tyne NE2 4PQ. 
Tel. 091-281 8481 
Price 


£389.85 Inc. VAT RU 
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French Light,Beok — 
French Demi-Bold ‘Bold 
eh ak Ultra Bold 


resdlution of 360 dot. per inch This ~_ can use 
A2*papér and is idéaffor professional work. 


Price, including the’Printer Driver, is £795.00, but we 
give up to 30% discount depending on status. 
Prices are exclusive of VAT and delivery 
ge. Catalogue of fonts to: 
ry, 18 Brockenhurst Road, ASCOT SL5 9DL 


" or felephone 0990-872923 (24 hours) 
We accept Visa, MasterCard, EUROCARD & Access 


MORLEY =..-£.C-T-R-0-N-1-C-SIEO 


THE WORLDS MOST POWERFUL MICRO 


A3000 £599 420/1 £1499 
410/14 £1099 440/1 £2099 


LEARNING CURVE £699 


Including Free Morley Analogue to 
Digital User Podule 


Se owees 


THE A3000 OPTION ACORN FORGOT ; 


Q) Easy to install simply plug in Q) Includes tull fitting kit and 


THE BEST VALUE MEMORY UPGRADES 


(Dy Easy to install simply plug in 

and run 

[Filly compatible with all Acorn 
software including desktop 
publisher 
A must for all serious 
Archimedes owners 
Make full use of Acorn’s 
powerful Desk-Top Publishing 
package 


1 Meg uparade gives you'a total 


of 2 Meg on-board 


1 Meg Upgrade 
3 Meg Upgrade: 

1 Meg to 3 Meg 
305 1/2 Meg 

400 Series 1 Meg 
400 Series 3 Meg 


ARCHIMEDES PERIPHERALS 


Colour Monitor £220 
Mono Monitor £73 
SOFTWARE 
Pipedream3 £147 
RiscOs Companion £49 
‘1st Word+ £69 
Autodesk CAD £79 
Acorn PC Emulator £99 
Acorn Desktop Pub. £149 
Clares ProArtisan £145 
Clares Artisan £29 


Clares Toolkit 
Clares Toolkit+ 


A3000 
Monitor Stand 
User Port & Midi Podule 
Serial Upgrade 
Econet Upgrade 


300/400 SERIES 
Acorn Rom Podule 

2 Slot Backplane 

4 Slot Backplane 

VO Podule 

Midi Podule 

Second 3.5" Drive 


(2) 1. Meg board upgradeable to 3 
Meg 


£129 
£349 
£229 
£89 
£99 
£299 


£49 
249 


and run instructions 
() High quality Japanese Drive Dual Drive Kit £125 
LEADS & MISC. HARDWARE ETC. 

Arch Monitor Leads: Printer Stand 80 col £15 
SCART £8 Printer Stand 185 col «£19 
9 Way 'D’ (Msync) £8 Tilt & Swivel Monitor 

Arch Serial Lead £8 Stand on 
Arch Printer Lead £6 Monitor Stand/plinth 

BBC Printer Lead £6 BBC £13 
2 to 1 Printer switch £20 Master £14 
3 to 1 Printer switch £30 BBC/Master SCSI 

410 1 Printer switch £36 Hard Disc interface £50 
64k Printer Butfer £115 Eprom Eraser £18 
256k Printer buffer £199 Eraser with timer £23 


(NOTE switching units & print buffers come with printer lead) 


The Morley TELETEXT 
ADAPTER is now available for 
the Archimedes. The specifica- 
tion including screen dumps etc., 
is the same as the BBC version 
but connection is via a Podule 
socket. £125 


EXISTING USERS OF OUR BBC 
TELETEXT ADAPTER 


WE CAN UPGRADE THE UNIT 
FOR THE ARCHIMEDES FOR 
£35 


RING FOR DETAILS. 


COMING SOON 
$T506 Hard Disk 
Interface Podule 
Ring for details 


We are now an Acorn dealer and 
service contre. If you would like to 
have a look at the A3000 or any 
other Acorn/Morley products 
please fool free to call in and 
discuss your requirements with 
our staff. 


1 
Kit includes: 5.25" Teac 80 track drive; case; power supply: 
interface and leads £169 


A3000SCSIPODULE £149 
310/400 SCSIPODULE £149 
EXTERNAL WINCHESTERS 


including SCSI Podule, cased drive, cable and leads 


20 meg £465 30 meg £495 
40meg£575 60-200 meg POA 


kk& NEW PRODUCT xxx 
A3000 BBC Analogue + User Port Podule 


Full specification BBC Analogue to digital and user port. The advanced port is 
accessible using ADVAL from BASIC 5 with all BBC OS byte calls supported. 


Morlav Hause. Off Norham Road. North Shields. Tyne & Wear NE29 7TY. Tel: (091) 257 6355. Fax: (091) 257 6373 


by Lee Calcraft 


SYS “Wimp_ProcessKey” (SWI &400DC) 

Last month we made use of a writeable 
icon to accept text input by the user. When a 
writeable icon such as this becomes active a 
so-called caret, or vertical cursor, appears 
within the icon, and the window containing 
the icon gains the input focus. This means 
that all input from the keyboard is directed 
to the parent application. 


When this occurs it is the responsibility of 
the application to pass back to the Wimp any 
key presses in which it has no interest. This 
means that the Wimp can then offer such key 
presses to other applications which might 
wish to respond to them. This is the way in 
which the so-called hot keys system operates 
on the Desktop. 


You may recall the HotKeys utility 
published in Risc User Volume 3 Issue 1. In 
this case the HotKeys application sat on the 
icon bar and reacted to hot key events 
passed to it, enabling the user to press “0” 
on the keyboard to open a directory viewer 
on Drive 0, or the Print key to save a screen, 
and so on. Such a program relies on the fact 
that if an application has the input focus it 
will pass on all key presses which it does not 
use. 


erial Port Status 
Writeable Icon] | 


Monitoring key presses returned by the Wimp 


We can make our application pass on 
unwanted key presses as follows. First we 
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Mastering the Wimp 
Part 9: Icons concluded 


must detect all key presses returned to our 
application by the Wimp. This is achieved 
by responding to Wimp Poll reason code 8 - 
the Key_Pressed event. To see how this 
works, insert the following line in the much 
modified program from part one of the 
series. It must be a version which uses a 
writeable icon (as described last month), 
Find the Wimp Poll CASE statement 
(originally at line 430) and insert the 
following line: 

WHEN 8:VDU4:PRINT TAB (0,0) ;block%!24 
7SPC3;VDUS 
This will cause the character code of any 
unprocessed key from the writeable icon to 
be displayed at the top left-hand corner of 
the Desktop background. 


Now run the task from the Desktop, and 
click on the writeable icon. If you type at the 
keyboard with keys not recognised by the 
writeable icon, such as the function keys, a 
key code will appear at the top left of the 
screen. What is happening is that the Wimp 
is returning all keys not recognised by the 
icon to the application which owns the caret 
(or which has the input focus). We are 
reading the value of these keys at block%!24, 
which is a part of the parameter block 
returned by the Wimp with reason code 8. 


You will now find that if you try to quit 
the Desktop by issuing Ctrl-Shift-F12, or 
F12 on its own, that nothing happens. This 
is because the Desktop itself makes use of 
the hot key facility to respond to these keys. 
You will have to click on the Close icon to 
stop the application before F12 becomes 
active again. 


To make our application pass on all 
unwanted key presses, simply replace the 
line in question with: 

WHEN 8:SYS "Wimp ProcessKey", block’! 
24 
This picks up the key value of each 
unwanted keypress, and returns it to the 
Wimp. The Wimp then offers it in turn to 
each task which has a window with the hot 
keys flag set (bit 12 of the window flags used 
in Wimp_CreateWindow). Most tasks, like 
our own, are not interested in such key 
presses, and have the hot keys flag unset. 
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So far we have implied that 
applications will return all keys passed to 
them by the Wimp Poll Key_Pressed event. 
This is not the case: many applications 
will wish to respond to certain keys in a 
special way. The File Find application from 
two issues back for example, trapped the 
Carriage Return code passed to it by the 
Wimp Poll Key_Pressed event. All other 
keys were passed on using 
Wimp_ProcessKey, but code 13 was 
responded to by the task, and not passed 
back. 


VALIDATION STRINGS 

An indirected writeable icon can employ 
a validation string to specify which 
characters should be accepted by it and 
which passed directly to the application via 
the Wimp Poll Key_Pressed event. In the 
case of an indirected text-only icon, such as 
the subject of our example, the four-byte 
word in the icon’s parameter block at R1+28 
may point to a validation string. 


In this example we set R1+28 to -1, 
indicating that no validation string was to 
be supplied, and that the writeable icon 
defaults should be used when determining 
which characters to accept and which not. 
To make use of a validation string, 
dimension a small area of RAM at the start 
of the program and insert a short string as 
follows: 

DIM val% &20:$valt="A~0-9" 

Now alter the statement used to create icon 
8 early in the program, replacing the -1 
(which appears as the penultimate 
parameter) by val%. This gives: 

i3handle%=FNicon (whandle$%, 32, -270, 30 
0,48, &800F535,"", text2%, val’, &20) 


Now if you run the task again, 
everything will be as before, except that 
you will no longer be able to enter 
characters 0-9 from the keyboard. They 
will instead be passed to the task by the 
Wimp Poll Key_Pressed event, and if you 
still have the VDU4 debugging line 
described above, you will see the key codes 
for the numeric keys appearing at the top 
left of the screen. 


The syntax for the validation string is 
somewhat involved. The first character in 
our string is an “A”, indicating a sequence of 
allowed characters. The tilde symbol (~) 
toggles whether a sequence is allowed or 


disallowed. In our example we used “A~0-9”. 
This is interpreted as Allow all normal 
characters, except those in the range 
following the tilde. 


To take another example, if you wanted 
to accept only upper case letters, the 
numbers 0-9 and commas full stops and 
colons, you could use: 

"AO-9A-2,.:" 


So far we have only looked at the “A” 
command within validation strings, there 
are four others: 

D the Display command 

F the Font command 

L the Line command 
and _S the Sprite name command 
The first can be used to conceal characters 
typed into an icon for use with passwords 
etc. The second supplies colours for anti- 
aliased fonts, the third tells the Wimp that a 
text icon may be formatted over a number of 
lines if it overflows the first, while the last 
permits a sprite name to be supplied for use 
with text and sprite icons, or for a pair of 
different sprites to be used for the 
highlighted and un-highlighted states of the 
same icon. 


If more than one validation command 
appears in the same string, semicolon 
separators must be used. Incidentally, if you 
wish to use the characters “-”,”~”,”\” or “;” 
for their own sake rather than as 
separators, you should precede them with a 
backslash. 


For further details of validation strings, 
the reader is referred to the PRM pages 
1184-1186. But as a parting shot, you might 
like to try one further example in the test 
program: 

"Aa-zA-2Z;D\-" 

This sets up the icon for password entry, 
accepting just upper and lower case 
alphabetical characters, and displaying 
them as a row of dashes. All other keys are 
returned by the Wimp Poll Key_Processed 


, event. 


EXCLUSIVE SELECTION GROUPS 

When an icon is initially defined using 
SYS Wimp_Createlcon, it is assigned to a 
so-called exclusive selection group (or ESG) 
by supplying a number between 0 and 31 in 
the icon flags (bits 16-20). If zero is used, 
then the ESG feature does not take effect, 
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but for any other value, the Wimp ensures 
that only one member of each group may be 
highlighted at any time. Thus if you assign 
three icons to ESG 1, selecting any one of 
them by clicking on it with Select will cause 
the other two icons in the same group to be 
automatically deselected. 


The effect of clicking with Adjust 
depends on the state of icon flag 10. If this is 
set, then selecting an icon with a non-zero 
ESG does not de-select the others in the 
group. You can see this in operation when 
selecting files in a directory viewer. 


We can easily set up an ESG in the test 
program. As it stands, all three test icons 
have been assigned to ESG 0, making them 
behave independently. But we can assign 
icons 1 and 2 to ESG 1 by altering the 
values of the fifth nibble of their icon flags 
from a zero to a one. Thus &800B43D 
becomes &801B43D and &800B53D 
becomes &801B53D. If you alter these two 
values (they are assigned early in the 
program just under the “CREATE 
WINDOW” REM), and then run the 
program, you will see that the two icons 
behave as predicted: if one is highlighted, 
clicking on the other will de-highlight it, 
and so on. If you make your selections with 
Adjust, you will see that they are no longer 
mutually exclusive, since flag 10 of both 
icons is set. 


As it stands, when the test application 
starts up, neither of the two icons in ESG 1 
are in a selected state. To remedy this, we 
can set flag 21 of one of the icons at the 
start of the program. In the case of the first 
icon, this involves changing its flag to 
&821B43D. 


THE ICON BAR 

So far we have only looked at tasks 
which are run by double-clicking on their 
own icon in a directory viewer. The 
alternative approach is for the application’s 
icon to be placed on the icon bar in response 


to a double click. This installs the 


application in the multi-tasking 
environment. It is then able to respond to 
further actions from the user, such as 
clicking on the icon on the icon bar to open a 
window. To terminate such applications, the 
user normally clicks Menu over the icon on 
the icon bar, and selects Quit from a menu 
which appears. We will begin to look at 
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menus next month, but while still on the 
subject of icons, we will deal with the 
installation of applications icons on the icon 
bar. 


This is achieved by supplying a value of -1 
(to install on the right) or -2 (to install on 
the left) in place of a window handle in 
Wimp_CreateIcon. We can easily try this 
out. If you add a new icon to the three 
already defined in the first few lines of the 
example program, as follows, this will do the 
trick: 

i4handle%=FNicon (-1, 0,0, 68, 68, &3002, 
"!wimp9",0,0,0) 
This is a simple sprite icon whose name is 
!Wimp9. This will work if the name of your 
application is !Wimp9, and that as a 
consequence there is a sprite of this name in 
the !Sprites file in the application directory. 


Running the program by double-clicking 
on the task’s icon in a directory viewer will 
run the task as before, but now the task’s 
icon will also appear on the right-hand side 
of the icon bar. This icon will have no effect, 
and will be removed once you terminate the 
task by clicking on its Close icon. 


To make the task behave like other 
applications using the icon bar, we would 
need to delay issuing SYS 
“Wimp_OpenWindow” until the user had 
clicked on the icon installed on the icon bar. 
But we will pursue this further once we 
have looked into the menu system used by 
the Desktop, since we will need to make use 
of this before our icon bar based task will 
work properly. Suffice it to say at this point, 
that when you install an icon on the icon 
bar, the application is loaded into memory 
and runs in multi-tasking mode in a very 
similar way to any fully-operational task. 
Consequently the more icons you have on 
your icon bar, even if the corresponding 
tasks do not appear to be active, the more 
memory you will tie up. 


Next month, as already indicated, we will 
launch into the topic of Wimp menus. 


This month’s magazine disc contains a 
souped up program for obtaining the values 
used in Window and Icon flags. Written by 
Graham Crow, and based on ideas from this 
series, it is fully mouse-driven, and a delight 


to use. RU 
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INVESTIGATOR 1.02 E> 


£24.95 


THE SERIAL PORT 


Investigator is a disc utility program which is compatible == 


with the Archimedes 300, 400 and 3000 series using 
either the Risc OS or Arthur 1.2 operating systems. ie | 
Investigator can perform the following operations on discs 


of many different formats: 

e@ Examine the format of the disc in detail. 
e Edit the data stored on the disc. 

@ Make backup copies of the disc. 


e Store the entire disc as an ordinary ADFS file. This 
may allow archives of several master discs to be stored 
ona single backup disc. The disc may then be 
transmitted to a remote site using a modem anda 
communications package such as ARCterm. 


@ Fully WIMP front end. 


The Serial Port, Burcott Manor, Nr Wells, Somerset BA5 INH 
Voice (0749) 72234 Data (0749) 79794 (300-2400 baud) 


Please send me [_] INVESTIGATOR 1.02 at £24.95, cheque, PO enclosed. 
Data Sheet 


Name 


Address 


Arcade 
A round-up of the latest games for the Arc 


by Peter Rochford 


L is a while since the last ARCade, 
mainly due to the lack of new games 
releases, which is somewhat the norm for 
this time of year. However, a number of 
new ones have appeared recently and I 
understand that there are quite a few 
more waiting in the wings from various 
software companies. 


OLYMPICS 

The Fourth Dimension has at last 
released the long-promised Olympics 
(£19.95), which is the first game of this 
type to appear for the Arc. This is a sports 
simulation comprising six different events 
for you to compete in, either against the 
computer or up to seven other people. 


<IRw> 
wITSIOS 


zOnM 
SHOOTING 


POIMY TOTALZOZ00 
SHOTS:20 PLAYERI2 


Olympics 


If you have played this type of game on 
other computers in the past, you may 
already have visions of your prized Arc 
being subjected to frenzied attacks of 
‘keyboard bashing’ by younger members of 
the family. Not so with this version: the 
author of the game has adopted a system 
of gameplay that relies more on timing 
and manual dexterity than frantic 
hammering of the keys to ensure your 
man gets a place on the winner's rostrum. 


The game opens with a classy-looking 
title screen and an excellent rendition of 
“Chariots of Fire”. You are then taken to 
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the main menu where you can elect to 
practise any of the events or take part in 
the competition. 


The events vary in the degree of 
difficulty; for example, the shooting is 
relatively easy, as is the javelin. The 
swimming and diving, however, are far 
from simple and require a great deal of 
concentration and practice to achieve any 
degree of success. 


The game features some excellent 
graphics and animation along with plenty 
of suitable digitised sounds for each event. 
The menu systems are clear and easy to 
use with the aid of the mouse, and your 
scores can be saved to disc for later recall. 


The Olympics features a classy 
presentation and plenty of variety to 
maintain lasting interest. To my mind, 
this is one of the better releases for the 
Are and should find favour with all 
members of the family. Definitely 
recommended. 


TRIVIAL PURSUIT 

Another game that should appeal to all 
the family is Trivial Pursuit (£29.99) from 
Domark. This is Domark’s first Arc 
release and should be followed shortly by 
the Amiga hit, Hard Drivin. 


I won’t bother to describe the game to 
you as it is likely that most people will have 
heard of or seen the board game of Trivial 
Pursuit. Here we have an exact screen 
replica of the TP board and the gameplay is 


. identical. The mouse is used to ‘roll’ the 


dice, and to move around the board, The 
usual categories of questions are included, 
and as an added enhancement to the 
original game, you get questions with 
graphics and sound too, Other 
enhancements include a statistics screen, 
and timers can be set to make sure people 
don’t dally too long and hold up the game. 


53 


Arcade 


54 


There are some 3000 questions held on 
disc, and Domark promises further 
questions discs soon. To answer a 
question, no typing is required; you just 
say the answer and then ask the computer 
for the correct answer. You then confirm 
whether you were right or wrong by 
clicking on the appropriate icon with the 
mouse. Domark’s Trivial Pursuit is a good 
computer representation of the real game. 
The Arc’s sound and graphics have been 
used to good effect to provide an extra 
degree of interest over the board game. It 
is equally addictive and inevitably 
produces the same kind of reactions when 
played in a group. Beware of flying mice! 


I like this game a lot, but then I have 
always been the kind of person whose 
mind is crammed with lots of generally 
useless information and enjoys the 
challenge of trying to retrieve it. 
However, at the end of the day I 
wonder whether you really need a 
computer to enjoy this game. The board 
version is just about the same price, 
and if you own it already why bother 
with this? No doubt those who are 
trivia freaks and want a different way 
of playing the game will find Domark’s 
offering irresistible. 


ROTOR 

Arcana is another new name to the 
world of Archimedes games. Its first 
release is called Rotor (£24.99) and 
bears some similarities to such games as 
Thrust on the Beeb. 


Basically, the idea of the game is, to 
guide a spaceship around a labyrinth of 
‘caves’ avoiding certain hazards and not 
allowing your ship to crash into the 
obstacles and walls. You must shoot 
certain items and collect others to enable 
you to work your way through the cave 
and effect your escape to the next. 


Control of the ship is via the mouse, 
although the keyboard can be used as an 
alternative. Practice screens are provided, 
and believe me you will need a lot of 
practice in this game. It is infuriatingly 


hard to get the hang of it, but you must 
master the ability to control the ship 
before you can really get into the game. 


The graphics are good but not what I 
would call outstanding for the Arc. The 
early screens in particular are fairly 
mundane but later ones are more 
colourful and more detailed. Sound is 
minimal but used to good effect. 


Overall I would say that this is a game 
for the dedicated games player and not 
the casual gamer who wants to while 
away the odd half hour. It takes a good 
deal of perseverance to get control of the 
ship, and some may be put off by this. 
Having said that, if you do bear with it 
and succeed, you will find it incredibly 
addictive. You have been warned! 


Trivial Pursult 


CAVERNS 

Minerva appears to be determined to 
dominate the games scene for the Arc, not 
satisfied with just a strong presence in the 
more serious sector of the market. The 
company has three new releases out now, 
Caverns (£17.95), Tank Battle (£14.95) and 


. Maddingly Hall (£14.95). 


Caverns is written by Tim Tyler of 
Repton fame, and is an arcade adventure 
much in the same vein as Rotor from 
Arcana. In fact, Caverns and Rotor are so 
similar it is pointless to describe Caverns 
in any great depth. The object of the 
game, and the gameplay, is slightly 
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different from Rotor but the fundamental 
idea behind the game is much the same. 


Where Caverns really does differ from 
Rotor is in the size of the playing area. 
This is much larger; in fact each of the 
fifteen screens is made up of an area 16 
times that of the monitor screen. There 
are maps to help! 


Remember that I said Rotor was not a 
game that you can get into easily; well 
Caverns is even more of a stinker to get to 
grips with initially. The effects of gravity 
on the ship are more marked than in 
Rotor and this reviewer was sure for quite 
a while that Minerva had released a 
totally unplayable game. Perseverance 
though will pay off, and mastery of ship 
control is again the key to this tough and 
frustrating game. 
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Maddingly Hall 


Caverns has what I would call 
reasonable graphics for an Arc game, 
though the sound is somewhat poor I feel. 
The identity of the author will be obvious 
to Repton fans, as there are certain 
similarities in style, features and 
presentation. 


If I had to make the choice between 
Caverns and Rotor, I would plump for 
Rotor. I found it easier to play and would 
say that the graphics and general feel of 
the game are that much more appealing. 
Don’t dismiss Caverns though; if you like 
a REAL challenge, go for it! 
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The other two games from Minerva 
arrived with me too late for anything 
other than a brief mention. 


TANK BATTLE 

Tank Batile is a straightforward ‘shoot 
‘em up’ where you control a tank and 
charge around a battlefield trying to avoid 
or destroy hordes of other tanks. The 
object of the game is to find a series of 
automatic defences to help save your 
country from enemy forces. Once found 
they must be activated. 


It’s all a bit simple and the graphics 
are not what you would call stunning. 
Sound consists of digitised samples, and 
with the volume turned up on your 
monitor, is guaranteed to convince the 
neighbours that World War 3 has started. 
Not my cup of tea this one, but it should 
appeal to younger members of the family, 


MADDINGLY HALL 

Finally, we have Maddingly Hall, a 
text and graphics adventure game which 
is of a ‘whodunnit’ nature. The game is set 
in a country house where Bertie Hall, a 
man who has blown his fortune on the 
horses, now seeks to solve his money 
problems by murdering his rich Aunt 
Agatha. 


I haven’t got very far with this game 
due to its late arrival as forementioned. 
What I have seen appears to be very good, 
with a nice parser and some amusing 
dialogue. Graphics are a welcome addition 
to any adventure game as far as I am 
concerned. The ones in this are 
particularly good, and there is a picture 
for every location. I look forward to 
getting further into this game in the 
future and on the basis of what I have 
seen so far, can recommend this, 
particularly for family fun. 


That’s it for this month. See you soon! 


All prices quoted inelude VAT, and all these 
games may be obtained through BEEBUG - 
see the Current Retail catalogue. 


55 


Hints & Tips... Hints & Tips 


SPEEDIER INTER-APPLICATION 


TRANSFERS 
Anthony Brion 


INSTR WITH 3 PARAMETERS, MID$ 


When transferring data from one multi- 
tasking application to another, some 
applications require the Wimp to perform 
this task, which it does by using a temporary 
file called Scrapfile. This is located in the 
!System directory, which means that if the 
dise containing !System is not in the drive 
you will be asked to replace it. 


Properly written applications will make 
their own arrangements to transfer data via 
RAM, and so will have no need to use 
ScrapFile. However, in the event that a 
poorly written task asks the Wimp to do the 
job, a solution to the disc-swapping problem, 
and incidentally a way to speed up the 
transfer itself, is to use the RAM filing 
system to store Scrapfile. To do this, you 
need to modify one line in the !Boot and 
!Run files of !System. The lines to look for 
read as follows: 


Set Wimp$Scrap <Obey$Dir>.ScrapFile 
They should be altered to: 
Set Wimp$Scrap RAM:$,.ScrapFile 


You must also make sure that the RAM 
filing system size is large enough for the files 
you are transferring. You can increase the 
size temporarily by dragging the RAM disc 
slider across on the Task Manager display. 


WITH 2 
Lee Calcraft 
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The INSTR function returns the position of 
one string in another. Thus: 

A%=INSTR ("ABCDEF", "DE") 
will return the value 4 because the string 
“DE” occurs at the fourth character from the 
left in “ABCDEF”. 


But INSTR can take 3 parameters, with the 
third supplying a starting point for the 
search. Thus: 

A%=INSTR ("DOGDOUGHNUT", "DO", 2) 
will return the value 4, because the search 


began at position 2 in “DOGDOUGHNUT”’. 
This can be useful for splitting up strings 
such as filenames, containing multiple 
separators. 


By contrast, the function MID$, which 
normally takes three parameters, may be 
used with two. Here, the statement: 

AS=MIDS ("ABCDE", n) 
with n=2 would set A$ to “BCDE”. The new 
string is made up of characters from A$ 
starting at the nth. 


THE OS_SerialOp SAGA CONTINUES 
David Spencer 


There is a (genuine??) mistake in the 
documentation of SWI OS_SerialOp 0 
(read/write status) in the RISC OS 
Programmer's Reference Manual. The 
definition for bit three is reversed. It should 
state that when the status bit is zero, the 
DTR (Data Terminal Ready) bit in the serial 
controller is set, signalling ready. When the 
bit in the status word is set to one, the DTR 
bit in the serial controller is reset, signalling 
not ready. DTR acts as a ‘master’ control, 
and when set to “not ready", disables both 
serial transmission and reception. 


PRINTING FROM BEDIT 
Thomas Down 


The BEdit utility published in RISC User 
Volume 3 Issue 4 is very useful, but there is 
no print option. This can be added by placing 
a copy of the PCol utility (RISC User Volume 
3 Issue 5) inside the !BEdit application 
directory and including the following line in 
the !RunImage file of BEdit: 

1575 *Key5 <0><&94>*/<BEdit$Dir>.PCol 2 

|MEDIT|M 


Now pressing Ctrl-Shift-F5 will print the 
current program in two columns. 
Alternatively you can place PCol in the 
library directory of any work disc and 
change the line to: 
1575 *Key5 <0><&94>*Mount <Discname>|M* 
/PCol 2|MEDIT|M 
making sure that the work disc is in the 
drive when issuing the command. 
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MERGING !SYSTEM 
David Spencer 


READING SYSTEM VARIABLES 
Lee Calcraft 


System variables are used by the operating 
system for many purposes. Reading their 
value by issuing commands at the star 
prompt is easy (e.g. try *ECHO <Sys$Time>). 


Here is a way to read their value from Basic 
or assembler. It makes use of SYS 
“OS_ReadVarVal”. On entry the following 
must be set: 


Ri1=Pointer to name (may be wildcarded) 
R2=Pointer to buffer (for result) 
R3=Maximum length of buffer 
R3=Name pointer (0 for first call) 

R4=8 if expanded string is to be 
returned (otherwise numbers are 
returned as 4-byte values, and 
macros are returned un- 

OS_GSTransed) 

On exit RO and R1 are preserved 

R2=Number of bytes read 

R3=New name pointer (for wildcard use) 

R4=Type of variable (string=0, 4-byte 
number=1 or macro=2) 


The following program demonstrates the 
call. If you enter the name of a system 
variable (e.g. Sys$Time) it will print its 
value. 
10 REM >ReadVarl 
20 REM by Lee Calcraft 
30: 
40 DIM name$ 100, result% 100 
50 REPEAT 
60 INPUT "OS Variable name", name$ 
70 PRINTFNreadvar (name$) 
80 UNTIL FALSE 
90 
100 DEFFNreadvar ($name%) 
110 SYS "OS ReadVarVal", name%, result’, 
100,,3 TO ,,dlen% 
120 result? (dlen%) =13 
130 =$result’ 


For further details, see the PRM page 750. 
For details of OS_SetVarVal used for 
setting the value of a system variable, see 
the PRM page 752. 
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The /System folder used with RISC OS is 
designed to hold shared resources that are 
likely to be used by many applications. For 
example, the standard contents are the 
shared C library, the Floating Point 
Emulator and the ColourTrans module, all 
of which are needed by most applications. 
The idea is that the use of /System 
prevents multiple copies of common 
resources using up valuable disc space. 


When installing a new application, it may 
have its own /System folder containing 
resources it needs, but which may also be 
useful to other applications. For example, 
quite a few commercial applications are 
written in Basic and then compiled, which 
requires the compiler's library to be in 
!System. In this case, the two /Systems 
need to be merged. To do this, simply open 
the directory displays containing each 
/System icon and drag the new one onto the 
existing one. RISC OS will correctly merge 
the two folders. 


This technique isn't restricted to just 
!System - it can be used to merge any two 
directories, or whole directory structures, 
having the same name. 


REAL VARIABLES IN BASIC V 
Ron Collins 


It appears that writing real (floating point) 
variables to a data file from Basic V 
results in the type byte being set to &80, 
and not &FF as stated in the Basic User 
Guide, and also as used by Basics I, II and 
IV. In practice, this makes little difference 
since the Basic statement INPUT# only 
reads the top bit of the data type byte, and 
will therefore correctly recognise floating 
point variables in data files written by 
earlier programs. However, you should be 
aware of this difference if you are writing 
programs which use BGET# to read the 
variable type. 
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PipeDream 3 breaks down the barriers between word processor, spreadsheet and database. You can 
include numerical tables in your letters and reports, add paragraphs to your spreadsheets, and perform 
calculations within your databases. 

Based on PipeDream 2, the best-selling integrated package for the Archimedes, PipeDream 3 has been 
completely re-written to take full advantage of RISC OS - if you can use RISC OS, you can use PipeDream 
3.Itis fully multi-tasking and multi-windowing, so youcan work onmany documentsat onceand instantly 
move information between them. And since PipeDream 3 can automatically load and save most popular 
file formats, including VIEW and First Word Plus, switching to it from other programs has never been 
easier. 


Power, flexibility, speed, ease of use. PipeDream 3. Breaking down the barriers. 
For a free brochure, see your Archimedes dealer, or phone us on 0954 211472 or return the coupon. 
PipeDream 3 is for all Archimedes computers with RISC OS and 1Mbyte of RAM. 
PipeDream 3 costs £147.00 +VAT. 


Major features include: 


* many documents loaded atonce  * automatic loading of VIEW, 


* intuitive RISC OS user interface ViewSheet, Lotus, First Word For a free brochure, complete and retum this coupon 

+ displaying and printing Plus, Tab and CSV files IPipeDream 30) View Professional () | 
of pictures within text * automatic saving of VIEW, [Name | 

+ built-in 93,003 word Lotus, Acorn DTP format, Tab Address 
spelling checker and CSV files | | 

* file compatibility with © multi-field sorting e | | 
PC & Z88 PipeDream and + use of all available fonts | Post code | 
BBC View Professional * 62 spreadsheet functions 

* background recal * external references for 3-D [cotton Software, Broadway House,149-151 St. Neots| 

+ keystroke compatibility modelling | Road, Hardwick, Cambridge CB3 7QJ, England. | 
with Z88 & PC PipeDream * macro file recorder Fax: 0954 211607 Tel: 0954 211472 

+ 288 filing system + slot protection 1 sags irs i} 


All trademarks aclnowied ed. The chart in the screen shown abooe was produced by sending mumbers from PipeLream 3 to Lingenuity's Presenter 2.and then loading the resulting graph 
back into PipeDream 3, 


Colton Software, Broadway House, 149-151 St. Neots Road, Hardwick, Cambridge, CB3 7QJ, England. 
Fax, 0954 211607 Tel. 0954 211472 
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USING DRAW FOR DTP 

The article on using the Draw application for 
DTP work is most interesting (see Into the 
Are RISC User Volume 3 Issue 3). Although, 
in a sense, Richard Mawhood only expands 
on what the user manual says, this is not the 
most informative of documents and any 
expansion is welcome. 


I would like to add some further comments to 
the article. The paper limits, for instance, are 
only shown if a printer driver is installed. 
The author says “unlike genuine DTP 
packages you can only work with one sheet of 
paper. If you want a multi-paged document, 
you will need to create separate text files for 
each page.” Not quite so! If you want to 
create, say, a three or four page A4 article, on 
the Miscellaneous menu set the page size to 
A2 portrait. Then set up page guides - just 
like the column guides described - for four 
separate A4 sheets, two at the top and two at 
the bottom. You can spread text between 
pages as you wish. Printing is a bit fiddly. 
You have to Select all and move the entire 
sheet until the required page is in the paper 
limits area. You can also have separate 
‘documents’ in memory in different Draw 
windows, but you cannot share a text area 
between them. 


Mr. Mawhood also omitted to say that you 
must select and delete your column guides 
(and page guides) before printing, or they 
will be faithfully reproduced along with the 
text and graphics, as I have often found to 
my embarrassment! 

Roger Amos 


HELP FOR NOVICE PROGRAMMERS 

I have recently purchased an A3000, mainly 
for the educational software available. 
However, I am also interested in learning to 
write my own programs. As a novice I would 
be grateful if you could advise me on 
appropriate instruction books? 

J.B.Willlams 


| strongly recommend that you obtain a copy of 
the BBC Basic Guide (supplied with the A400/1 
series) published by Acorn and available for 
£19.95. This will certainly provide a reference 
to the BBC Basic V used by your A3000, and 
this manual has a useful 170 page tutorial 
section. As far as | know, there is no 
introductory book yet published on programming 
in Basic V. However, this version of Basic is 


simply an extension of the BBC Basic used on 
older BBC micros, for which a good many 
excellent books have been published in the 
past, and any of these may well provide a good 
deal of help to those learning to program in BBC 
Basic for the first time. It is not worth giving any 
specific recommendation as you will need to 
check with bookshops and other sources to see 
what is still available. In conjunction with such a 
book, you may find that Basic V published by 
Dabs Press at £9.95 is helpful as this covers 
specifically all the additional features in Basic V 
compared with earlier versions (both manual 
and book can be supplied by BEEBUG - see the 
Retail Catalogue). 


MORE SIMPLE PROGRAMS PLEASE 
Please let’s have lots more easy programs for 
the beginner like me. I have had an A3000 
for only a month or two, and I find it so 
different from the 48K Spectrum we owned 
that it is like re-learning to use a computer 
all over again. 


In RISC User Volume 3 Issue 4 a letter from 
R.Rainthorpe asked why simple programs 
and applications should be printed. The 
reason I hope is to help people like me. I copy 
the programs which interest me and modify 
them for my own use. So far I’ve got Volume 
1 of RISC User to plough through before I 
move on to Volume 2. I like some of your 
early graphics programs, and my son loves to 
type in the simple programs and watch the 
result. More please. 


Keep us beginners happy and you may make 
programmers of us some day. 
Ivor Clarke 


Point taken - because users become more 
knowledgeable as time goes by, programs and 
articles submitted and published in the 
magazine tend to become more sophisticated. 
We often suggest that beginners consider 
buying some of the earlier issues which 
contain much useful information. Do note 
though that RISC OS and the Desktop as we 
now know it only appeared early last year, with 
magazine coverage from Volume 2 onwards. 
Most programs published before then will work 
with no problems at all, but cannot be run 
directly from the Desktop. 


All back issues are currently still in stock and 
prices and other details are given near the end 
of each issue facing the inside back cover. (RW 


— ——Y—X—h 
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ARE YOU GOOD ENOUGH? 


As the leaders in software for the Archimedes range ot computers, CLARES 
MICRO SUPPLIES are looking to extend our range even further. We are 
looking for people who are as excited by the Archimedes as we are. 


If you have written any programs, completed or not, then we would like 
to hear from you. 


If you have any ideas for programs and have the ability to execute the 
ideas then we want to hear from you. 


If you have the ability to program the Archimedes but not the ideas to 
program then we want to hear from you. 


Programs can be written in any language as long as they perform their 
stated task. Many of our programs contain large chunks of BASIC with 
ARM code in the areas that it is needed. BASIC on the Archimedes is a 
very powerful language and we do not attach any snob value to its use. If 
your program does what is meant to do then thats all we are interested in. 
Why not join the top team on the Archimedes. You get the support of our 
in-house team, privileged access through us to Acorn and invitations to 
our informal programmers seminars. 


The most important point is that you will be earning top royalty rates of if 
you prefer we will purchase your program outright. 


Please write, in confidence, to Mr. D. Clare at: 


Clares Micro Supplies, 
98 Middlewich Road, 
Northwich, 
CHESHIRE CW9 7DA 


If you have a program either complete or in development then please 
enclose a copy for our evaluation. 


To protect yourself we advise that you lodge a copy of the program with 
your bank or solicitor BEFORE you send us a copy. You can then prove 
that your program pre-dates anything that we have. 


Act today and become part of the leading software team producing 
software for the worlds fastest micro. 


MY 


Technical Queries 


Dear Sir, 
When you are In Basic or command 
mode can you get back to the Desktop 
without typing “Desktop each time? 

Ivor Clarke 


By ‘the Desktop’ I presume you mean the 
Desktop display as it existed prior to leaving 
it - after all, pressing Ctrl-Break will always 
restore the Desktop (provided this is 
configured as the start-up system), but of 
course resets the system as well. 


There are two routes that can be followed in 
leaving the Desktop, and the route chosen 
initially determines what choices are 
available to return. The simplest exit is to 
press F12 which gives the command prompt 
at the foot of the screen, and is ideal for quick 
temporary excursions to the command line. 
There are two other ways of making this exit. 
Press the Menu button while pointing to the 
Task Manager icon on the icon bar, and select 
the *Commands (f12) option from the 
resulting menu. If you have the Task 
Manager display on screen, pressing the 
Menu button over this window will reveal a 
menu containing this same option. 


When the star prompt is present, pressing 
Return (with no other input) should return 
you to the original Desktop display. If you 
leave the Desktop by the route described, 
and then select Basic (by typing Basic in 
response to the prompt), typing *QUIT at 
any time will get you back to the star 
prompt, whereupon, pressing just Return 
will again restore the Desktop display. 


In fact, with this route you have not really 
left the Desktop environment at all. Instead, 
the Task Manager starts a non-multi-tasking 
task which effectively takes over until you 
decide to terminate. As with any other task, 
on exit the Desktop is re-drawn. You can 
check this in that if you select the 
*Commands option from the Task Manager 
menu, and enter the command SHELLCLI 
you will find that the system responds just 
as it would if F12 had been pressed (or 
selected from the menu). 


The other route for leaving the Desktop is to 
press Ctrl-Shift-F12. This should be regarded 
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as a long term exit - the screen clears 
completely leaving just the star prompt on a 
black background at the head of the screen. 
Pressing Return now has no effect other than 
to repeat the star prompt. Entering Desktop 
in response to the prompt will return you to 
the Desktop, but only the default Desktop 
that you see on start-up or after Ctrl-Break. 
If you use this route to enter Basic, then 
*QUIT will get you back to the star prompt 
as before, but again *Desktop is the only way 
back to the default Desktop display. 


Thus the first route is the preferred one if you 
want to preserve the Desktop, but bear in mind 
even then, that this may prove impossible 
depending on what you do or what programs 
you run when out of the Desktop. It also ties 
up memory which can only be reallocated if 
you use the Ctrl-Shift-F12 method. 

Mike Willlams 


Dear Sir, 
The latest version of the Programmer's 
Reference Manual, which | recently 
recelved, does not describe the old 
Bitmap Font Manager which Is present In 
my A3000. Can you provide me with the 
relevant detalls? 

A.P.Hamilin 


The two Font Managers are the same, except 
that the following SWI calls and star 
commands are not implemented in the 
bitmap version: 


Font_MakeBitmap 
Font_UnCacheFile 
Font_SetFontMax 
Font_ReadFontMax 
Font_ReadFontPrefix 


*Configure FontMax 
*Configure FontMaxl etc 


* In addition the Outlines, f9999x9999 and 


b9999x9999 files do not exist. In practice 
this makes little difference, as the above 
calls are only likely to be used for cache 
optimisation by font-intensive applications 
such as DTP. More information on the 
*Configure options was also given in 
Technical Queries Volume 3 Issue 4. 

Glynn Clemments /U 
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BEEBUG 


The Archimedes Specialists 
Beebug Hardware Upgtades for the A3000 and Archimedes 


BEEBUG 
Hard Drives for the 400/1 series 


‘The BEEBUG internal hard disc upgrades use 
only high quality mechanisms from respected 
manufacturer's such as NEC, Rodime and Seagate. 
All our drives are easy to fit. 


Q All drives have an access time of less than 29ms 
Q 40 & 53Mb drives feature autoparking 

Q Full 12 months warranty 

Q 53Mb drive uses the top of the range Rodime 

_ drive as used in the Archimedes 440/1 

Q All drives fully tested and formatted prior to 
despatch 

O Free fitting (by appointment) if brought to our 
showroom 

Q Backed by the resources of Beebug 

© pull fitting instructions included 


0120G Beebug A400 20Mb Drive £199.95 
0121G Beebug A400 40Mb Drive £326.95 
0122G Beebug A400 50Mb Drive £499.95 


BEEBUG 


PGAUIOM Dy Crom titre 


An exciting new release for the A3000 allowing 
the connection of 5.25" drives to the A3000. Some 
of the features include: 


Q Connector for BBC-type 5.25" & 3.5" drives 

2 On board switches allow drive mapping to be 

changed. eg. The internal drive could be made 

drive 1, and an external drive as drive 0 - ideal 

for the PC emulator 

Whole interface contained on an internal card 

Easy to fit, supplied with full instructions 

Will work with most drives that have an internal 

Power Supply Unit 

Q an read DFS files with optional DFS Reader 

Q {nternal and external drives can be double 
stepped to read 40 track discs 

Q full 12 months warranty 


ooo 


439.95 


0135C A3000 buffer 
0102B DFS reader 


417 Hatfield Road, St Albans, Herts AL1 4JS 


Prices quoted are for BEEBUG members and include V/ 


Prices and specifications suk 


BEEBUG 
A3000.Memory Upgrades 


The BEEBUG A3000 memory upgrades are 
available in either 1 or 3 Mb versions and are easy 
to fit by the user. This will give a total of either 
2Mb or a massive 4Mb of memory. 


By using the latest surface mount technology we 
have achieved a board size of a mere 256x46 mm, 


‘The 1 Mb board can be easily upgraded to 3 Mb at| 
any time by the user, unlike some other boards on! 
the market. 


Easy to install with fitting instructions provided 
Full 12 months warranty 

1 Mb expandable to 3Mb by the user 

Uses latest surface mount technology 

Free fitting (by appointment) if required 


ooooo 


_ 0130D Beebug A3000 Memory 1Mb $164.95 
0131D Beebug A3000 Memory 3Mb £399.95 
0132C 1Mb to 3Mb upgrade 


&250.95 


BEEBUG 
Archimedes 5.25" Disc Buffer MK II 


A high quality buffer mounted neatly and simply in 
the back a 300 or 400 series Archimedes. 

Q Almost any 5.25" drive with a PSU may be used 

a Up to four drives (two external, two internal) 

Q Full buffering of signal from computer 

Q  prp switches allow re-mapping of drives 


0795C 5.25" Buffer (305/310/440) £33.25 
0784C 5.25" Buffer (400/1 series) £33.25 
0102B DES reader & 9.90 


BEEBUG Serial Link Kit 


|. A fast, convenient method of transferring data 
-between the BBC Micro/Master and the Arch, 
© 43000 users will require the A3000 serial chips. 
Q ‘Transfer in both directions 
Q winp driven, easy to use software 
Q Compatible with both DFS and ADFS files 
O Includes software, 3m cable and instructions 


& 9.90 0796C Serial Link Kit 817.25 


(0727) 40303 FAX: (0727) 60263 


ails on postal chz 


Telephon 
See Retail. 


yject to change wil nolice. 
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